List Commissions | Anderro Docs

GET/api/v1/commissions

Returns a paginated list of commissions for the product associated with your API key. Each commission represents an affiliate earning from a referred payment.

Query parameters

Parameter	Type	Description
`status`	string	Filter by status: pending, approved, paid, rejected, or refunded.
`affiliate_id`	string	Filter by affiliate profile ID.
`created_after`	string	ISO 8601 date - only return commissions created after this date.
`created_before`	string	ISO 8601 date - only return commissions created before this date.
`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/commissions?status=approved&limit=20" \
  -H "x-api-key: sk_your_secret_key"

Responses

200Paginated list of commissions

json

{
  "data": [
    {
      "id": "comm_abc123",
      "amount_cents": 980,
      "status": "approved",
      "hold_until": "2026-05-01T00:00:00.000Z",
      "created_at": "2026-04-01T14:30:00.000Z",
      "affiliate": {
        "id": "ap_xyz789",
        "email": "[email protected]",
        "name": "Jane Smith"
      },
      "referral_code": "jane-smith",
      "customer_email": "[email protected]",
      "payment_amount_cents": 4900
    }
  ],
  "pagination": {
    "next_cursor": "dGhpcyBpcyBhIGN1cnNvcg",
    "has_more": true
  }
}

Commission lifecycle

Commissions start as pending during the hold period (configurable in your product settings). After the hold period passes, they move to approved and become eligible for payout. Once included in a completed payout, they become paid.

If the underlying customer payment is fully refunded via POST /api/v1/refunds or an automatic Stripe charge.refunded webhook, the commission flips to refunded and amount_cents is zeroed out. Partial refunds proportionally reduce amount_cents but leave the status unchanged.