---
title: "List Affiliate Payouts"
method: GET
path: "/affiliates/{affiliate_id}/payouts"
tags: ["Affiliates"]
---

# List Affiliate Payouts

`GET /affiliates/{affiliate_id}/payouts`

Returns the affiliate's payouts from the project — both the monthly `performance` payouts their codes earn and the `custom` ones the project created — latest period first. Note 1: this endpoint is only accessible with a secret API key. Note 2: up to 100 payouts are returned per request; page through the rest with `offset`.

## Path parameters

- `affiliate_id` string, required

## Query parameters

- `limit` number
- `offset` number

## Headers

- `x-api-key` string, required

## Response `200`

The page of payouts.

- AffiliatePayoutListResponse
  - `data` AffiliatePayoutList, required
    - `payouts` AffiliatePayout[], required — The page of payouts: latest period first, and the newest first within one
      - `id` string, required — The payout id
      - `affiliate_id` string, required — The id of the affiliate the payout is to
      - `type` 'performance' | 'custom', required — What the payout is: `performance` collects what the affiliate earned in a calendar month; `custom` is an amount the project set itself
      - `status` 'upcoming' | 'holding' | 'pending' | 'processing' | 'sent' | 'completed' | 'failed' | 'cancelled', required — Where the payout is: `upcoming` and `holding` still collect or wait out refunds, `pending` is ready to be sent, `processing` is on its way, `completed` has been paid, `failed` goes back to pending, `cancelled` will not be paid
      - `amount` integer, required — The amount, in USD cents
      - `description` string, nullable, required — What a `custom` payout is for, as the project put it. Null for `performance` payouts
      - `period_start` string, date, required — The first day the payout covers, in UTC
      - `period_end` string, date, nullable, required — The last day the payout covers, in UTC. Null while an `upcoming` payout is still collecting
      - `created_at` string, date-time, required — When the payout was created
      - `completed_at` string, date-time, nullable, required — When the payout was paid. Null until it is
    - `pagination` Pagination, required
      - `limit` number, required — How many results were requested
      - `offset` number, required — How many results were skipped before this page
      - `total` number, required — How many results matched in total, across every page
      - `has_more` boolean, required — Whether another page follows this one

## Other responses

- `401` — Unauthorized
- `404` — The affiliate is not on the project.
- `422` — The request is invalid.
- `429` — The rate limit for this endpoint has been exceeded.

## Changes

- **2026-09-30** `f3e82ba251e6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/winwinkit/apis/winwinkit-api/changes/affiliates/:affiliate_id/payouts/get.md)

---

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