List maker-checker actions

GET

/entity-maker-checker-actions

Returns the maker-checker actions belonging to the authenticated identity's entity, ordered newest first. A maker-checker action guards a sensitive operation (such as a payout, card creation, voucher creation, or team invite) behind one or more approvers before it is allowed to proceed. The entity_id and identity_id used for scoping and per-record flags are both derived from the authenticated session and are not accepted as query parameters.

Each returned action includes an is_next_approver flag indicating whether the calling identity is the approver expected to act next (only ever true while the action is pending), and an is_requester flag indicating whether the calling identity originally logged the action. Use the optional type and status filters to narrow the result set, and use the pagination cursor to move through larger histories.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Maker-checker actions retrieved successfully. The payload is a paginated array of actions for the authenticated entity.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/entity-maker-checker-actions?cursor=01JABC1234567890ABCDEFGHIJ&limit=20&type=payout&status=pending' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page with additional results

{
    "message": "Maker-checker actions retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01JMCA1234567890ABCDEFGHIJ",
            "entity_id": "01JENTITY1234567890ABCDEF",
            "reference_id": "01JPAYOUT1234567890ABCDEF",
            "type": "payout",
            "maker_checker_group_id": "01JMCG1234567890ABCDEFGHI",
            "requester_identity_id": "01JIDENT1234567890ABCDEFG",
            "requester": {
                "id": "01JIDENT1234567890ABCDEFG",
                "name": "Jane Doe",
                "email": "jane.doe@example.com"
            },
            "approvers": [
                {
                    "approval_order": 1,
                    "identity_id": "01JIDENT234567890ABCDEFGH",
                    "identity": {
                        "id": "01JIDENT234567890ABCDEFGH",
                        "name": "John Smith",
                        "email": "john.smith@example.com"
                    }
                }
            ],
            "approvals": [],
            "status": "pending",
            "status_reason": null,
            "amount": 25000,
            "currency": "NGN",
            "counterparty": null,
            "is_next_approver": true,
            "is_requester": false,
            "created": 1736899200000,
            "updated": 1736899200000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01JMCA1234567890ABCDEFGHIJ",
            "has_more": true
        }
    }
}

Modified at 2026-09-30 00:29:45

Retrieve a maker-checker action's status

Withdraw a maker-checker action