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",
      "level": 1,
      "parent_commission_id": null,
      "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.

level is 1 for the attributing (direct) affiliate and 2 for a sponsor override when 2nd-tier commissions are enabled. Tier-2 rows set parent_commission_id to the Tier-1 commission for the same payment. See 2nd-tier commissions.

If the underlying customer payment is fully refunded via POST /api/v1/refunds or an automatic Stripe charge.refunded webhook, all commissions for that payment (Tier 1 and Tier 2) are clawed back. Partial refunds proportionally reduce each row's amount_cents.