GET
/api/v1/payoutsReturns a paginated list of payouts for the product associated with your API key. Each payout bundles one or more approved commissions for a single affiliate.
Rejecting a pending payout deletes it, so it disappears from this list. Its commissions are released back to approved, and its adjustments become unapplied for a future payout. There is no stored rejected status. When marking a payout paid, reference is stored as its transfer ID (stripe_transfer_id in payout details).
Query parameters
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by status: pending, approved, processing, completed, or failed. |
cursor | string | Pagination cursor from a previous response. |
limit | integer | Number of results (1–100). Defaults to 50. |
Example request
bash
curl "https://anderro.com/api/v1/payouts?status=pending&limit=20" \
-H "x-api-key: sk_your_secret_key"
Responses
200Paginated list of payouts
json
{
"data": [
{
"id": "pay_abc123",
"amount_cents": 24500,
"status": "pending",
"commission_count": 5,
"paid_at": null,
"created_at": "2026-04-01T00:00:00.000Z",
"affiliate": {
"id": "ap_xyz789",
"email": "[email protected]",
"name": "Jane Smith"
}
}
],
"pagination": {
"next_cursor": "dGhpcyBpcyBhIGN1cnNvcg",
"has_more": false
}
}
Payout lifecycle
Payouts are automatically created when an affiliate's approved commissions exceed the payout threshold. They start as pending and require your approval. After approval, you can mark them as paid via the Update Payout endpoint.