Payouts
Get a paginated list of payouts with optional filtering
Authorizations
Query parameters
limitintegerOptional
Number of items to return
afterstringOptional
Specifies the cursor after which to start returning results. For the first page, this should be left empty. For subsequent pages, use the value of the end_cursor field from the previous response.
beforestringOptional
Specifies the cursor before which to return results. Use this to paginate backwards. For example, to load the previous page, provide the value of the start_cursor field from the last response.
statusstring · enumOptionalPossible values:
Filter by payout status
customer_idstringOptional
Filter by customer ID
invoice_idstringOptional
Filter by invoice ID
start_datestringOptional
Filter by start date (RFC3339 format)
end_datestringOptional
Filter by end date (RFC3339 format)
Responses
200
OK
application/json
400
Bad Request
application/json
get
GET /payouts HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*
{
"data": [
{
"arrival_date": "text",
"created_at": "text",
"customer_id": "text",
"fees": [
{
"amount": 1,
"covered_by_customer": true,
"name": "text",
"type": "unspecified"
}
],
"id": "text",
"status": "unspecified",
"sub_total": 1,
"total": 1
}
],
"end_cursor": "gaFpxBACEaXBVABEYbHG+X9LyLnH",
"has_next_page": true,
"has_previous_page": false,
"start_cursor": "gaFpxBACEaXBVABEYbHG+X9LyLnH"
}
Get payout details by ID
Authorizations
Path parameters
idstringRequired
Payout ID
Responses
200
OK
application/json
404
Not Found
application/json
get
GET /payouts/{id} HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*
{
"arrival_date": "text",
"created_at": "text",
"customer_id": "text",
"fees": [
{
"amount": 1,
"covered_by_customer": true,
"name": "text",
"type": "unspecified"
}
],
"id": "text",
"status": "unspecified",
"sub_total": 1,
"total": 1
}
Get payout transactions by ID
Authorizations
Path parameters
idstringRequired
Payout ID
Responses
200
OK
application/json
404
Not Found
application/json
get
GET /payouts/{id}/transactions HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*
{
"payout": {
"arrival_date": "text",
"created_at": "text",
"customer_id": "text",
"fees": [
{
"amount": 1,
"covered_by_customer": true,
"name": "text",
"type": "unspecified"
}
],
"id": "text",
"status": "unspecified",
"sub_total": 1,
"total": 1
},
"transactions": [
{
"description": "text",
"direction": "credit",
"failure_reason": "text",
"id": "text",
"method": "standard_ach",
"status": "created",
"sub_total": 1,
"total": 1
}
]
}
Was this helpful?