List a payout intent action's status history

GET

/payout-intent-action-status-logs

Returns a paginated, chronological (oldest first) timeline of status transitions recorded for a single payout intent action. Every time the action's status changes (for example when it moves from pending to processing, or is later returned), a status log entry is appended capturing the new status, an optional reason, and a snapshot of provider/system context at that step. Use this to audit or display the full lifecycle of a disbursement attempt. Pagination is cursor-based: pass the cursor value from the previous response's meta.pagination.cursor field to fetch the next page. When has_more is false, you have reached the end of the list.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Payout intent action status logs retrieved successfully. Returns a page of status log entries and pagination metadata.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/payout-intent-action-status-logs?payout_intent_action_id=01HQZR2BKPFQ8MXJVT3G7LWNZ&cursor=01HQZR2BKPFQ8MXJVT3G7LWNA&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — more results available

{
    "message": "Payout intent action status logs retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWPA",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "payout_intent_action_id": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "payout_intent_id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "status": "pending",
            "status_reason": null,
            "system_meta": null,
            "created": 1754524800000
        },
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWPB",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "payout_intent_action_id": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "payout_intent_id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "status": "processing",
            "status_reason": null,
            "system_meta": {
                "provider_code": "flutterwave-payout",
                "provider_reference": "FLW-REF-88213"
            },
            "created": 1754524860000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWPB",
            "has_more": true
        }
    }
}

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

Record a payout intent action as returned

Apply an action to a payout intent's schedule