List Payouts

GET

/payouts

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location '/payouts?created_from=2026-01-01T00%3A00%3A00Z&created_to=2026-01-31T23%3A59%3A59Z&status=paid&limit=20&cursor=eyJjcmVhdGVkX2F0IjoiMjAyNi0wMS0wMVQwMDoyNTowM1oiLCJpZCI6InR4bl8ybjVuOFRrTHAzVmRSd1FlIn0' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example

{
    "data": [
        {
            "id": "txn_2n5n5x9hqNx3MoNE",
            "type": "payout",
            "requested": {
                "amount": "1000.00",
                "currency": "XTS"
            },
            "processed": {
                "amount": "1000.00",
                "currency": "XTS"
            },
            "requisite": {
                "type": "card",
                "card": "4242424242424242",
                "holder": "Test User",
                "bank": "Test Bank"
            },
            "status": "paid",
            "status_code": "paid",
            "created_at": "2026-01-01T00:21:56Z",
            "expires_at": "2026-01-01T00:22:56Z",
            "finalized_at": "2026-01-01T00:34:12Z",
            "metadata": {}
        }
    ],
    "pagination": {
        "has_more": true,
        "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMS0wMVQwMDoyMTo1NloiLCJpZCI6InR4bl8ybjVuNXg5aHFOeDNNb05FIn0"
    }
}

Create Payout

Retrieve Payout