Manage payable approvals

Learn how to manage the invoice approvals to start the payable flow.

Overview

If the approval policy includes an approval request function, approving a payable is the next step after the payable creation.

List all approvals

To list all approvals, call GET /approvals:

curl GET 'https://api.sandbox.monite.com/v1/approvals?order=asc&limit=100' \
     -H 'X-Monite-Version: 2023-03-14' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN' 

You can filter the results and paginate through them by using the following query parameters:

ParameterTypeDescription
orderstringPossible values: asc (default), desc.
limitintegerMax value: 100.
pagination_tokenstringA token, obtained from the previous page. Prior over other filters.
statusstringPossible values: active, approved, rejected, discarded.
created_at__gtstring($date-time)Returns approvals created later than the specified date/time.
created_at__ltstring($date-time)Returns approvals created earlier than the specified date/time.
created_at__gtestring($date-time)Returns approvals created later than or at the specified date/time.
created_at__ltestring($date-time)Returns approvals created earlier than or at the specified date/time.

Retrieve a specific approval

To retrieve a specific approval, call GET /approvals/{approval_id}:

curl GET 'https://api.sandbox.monite.com/v1/approvals/{approval_id}' \
     -H 'X-Monite-Version: 2023-03-14' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN' 

Approve the request

To approve the request, call PUT /approvals/{approval_id}/approve:

curl -X PUT 'https://api.sandbox.monite.com/v1/approvals/{approval_id}/approve' \
     -H 'X-Monite-Version: 2023-03-14' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN' 

Reject the request

To reject the request, call PUT /approvals/{approval_id}/reject:

curl -X PUT 'https://api.sandbox.monite.com/v1/approvals/{approval_id}/reject' \
     -H 'X-Monite-Version: 2023-03-14' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN'