Get Payout History (Multiple)

Retrieve a list of past payouts. You can filter by currency, date range, status, or merchant IDs.

AuthorizationBearer

OAuth 2.0 access token

merchantIdsstringOptional

Comma-separated list of merchant IDs (UUIDs) to filter by

currencyenumOptional

Filter by currency code

startDatedatetimeOptional

Start date for filtering (ISO 8601 format)

endDatedatetimeOptional

End date for filtering (ISO 8601 format)

statusenumOptional

Filter by payout status

Allowed values:

limitintegerOptionalDefaults to 50

Maximum number of records to return

offsetintegerOptionalDefaults to 0

Number of records to skip

Successful response with payout history

payoutslist of objects

totalinteger

Total number of payouts matching the filter

403

Forbidden Error

1	{
2	"payouts": [
3	{
4	"id": "payout_8f3b2c1d9a7e4f2b",
5	"currency": "NGN",
6	"amount": 15000.75,
7	"status": "completed",
8	"createdAt": "2024-01-15T09:30:00Z",
9	"recipientType": "individual",
10	"recipient": {
11	"name": "John Doe",
12	"accountNumber": "XXXXXX1234",
13	"bank": "First Bank Nigeria"
14	},
15	"completedAt": "2024-01-15T12:45:00Z",
16	"reference": "INV-20240115-0001",
17	"description": "January salary payout"
18	}
19	],
20	"total": 1
21	}

1	curl https://api.crisscross.money/v1/payouts/history \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"