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

# List payouts

`GET /affiliate-payouts`

## Request

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

Read-only. Payout runs are approved by the account owner in the dashboard, never over the API.

## Query parameters

- `limit` integer
- `cursor` string
- `status` string
- `affiliate_id` string
- `run_id` string

## Response `200`

A page of payouts

- AffiliatePayoutListResponse
  - `data` AffiliatePayout[], required
    - `object` 'affiliate_payout', required
    - `id` string, required
    - `affiliate_id` string, required
    - `run_id` string, nullable
    - `amount_cents` integer, required
    - `currency` string, required
    - `method` 'stripe_connect' | 'paypal' | 'wise' | 'bank' | 'other', required
    - `status` 'pending' | 'processing' | 'paid' | 'failed' | 'cancelled', required
    - `stripe_transfer_id` string, nullable
    - `external_reference` string, nullable
    - `failure_reason` string, nullable
    - `paid_at` string, date-time, 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)
