List Payouts

Retrieve a paginated list of payouts with optional status filtering.

GET/api/v1/payouts

Returns 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.

Query parameters

ParameterTypeDescription
status
stringFilter by status: pending, approved, processing, completed, or failed.
cursor
stringPagination cursor from a previous response.
limit
integerNumber 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.