Manage payable approvals

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:

Parameter	Type	Description
`order`	string	Possible values: `asc` (default), `desc`.
`limit`	integer	Max value: 100.
`pagination_token`	string	A token, obtained from the previous page. Prior over other filters.
`status`	string	Possible values: `active`, `approved`, `rejected`, `discarded`.
`created_at__gt`	string($date-time)	Returns approvals created later than the specified date/time.
`created_at__lt`	string($date-time)	Returns approvals created earlier than the specified date/time.
`created_at__gte`	string($date-time)	Returns approvals created later than or at the specified date/time.
`created_at__lte`	string($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'