---
title: "List commissions"
method: GET
path: "/affiliate-commissions"
tags: ["Affiliates"]
---

# List commissions

`GET /affiliate-commissions`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/affiliate-commissions`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `status` string
- `affiliate_id` string
- `referral_id` string
- `currency` string
- `created_after` string, date-time
- `created_before` string, date-time

## Response `200`

A page of commissions

- AffiliateCommissionListResponse
  - `data` AffiliateCommission[], required
    - `object` 'affiliate_commission', required
    - `id` string, required
    - `affiliate_id` string, required
    - `referral_id` string, nullable
    - `tier` 1 | 2, required: 2 = second-tier (recruiter) commission
    - `status` 'pending' | 'earned' | 'paid' | 'reversed', required
    - `amount_cents` integer, required
    - `sale_amount_cents` integer
    - `currency` string, required
    - `description` string, nullable
    - `stripe_invoice_id` string, nullable
    - `stripe_charge_id` string, nullable
    - `earns_at` string, date-time, required: When the hold ends and a pending commission becomes earned
    - `earned_at` string, date-time, nullable
    - `paid_at` string, date-time, nullable
    - `reversed_at` string, date-time, nullable
    - `reverse_reason` 'refund' | 'partial_refund' | 'dispute' | 'manual' | 'fraud', nullable
    - `payout_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Validation error (`details.fields` names each bad field)
- `401`: Missing or invalid API key
- `403`: The API key is not full access, or the action is not allowed

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)