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

# List affiliate payouts

`GET /admin/affiliate-payouts`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/affiliate-payouts`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/affiliate-payouts/get.ts> (a function with typed inputs; its response is checked against the schema)

List payouts across every affiliate with their claim/settlement history, filterable by address search/status, offset-paginated (internal).

## Query parameters

- `search` string
- `status` string
- `limit` integer
- `offset` integer

## Response `200`

A successful response.

- ApiListAffiliatePayoutsResponse
  - `payouts` ApiAffiliatePayoutAdminDto[]
    - `payout_id` string
    - `affiliate_address` string
    - `week_start` string
    - `week_end` string
    - `gross_fee` string
    - `earned_amount` string
    - `paid_amount` string
    - `status` string
    - `finalized_at` string
    - `claims` ApiAffiliatePayoutClaim[]
      - `settlement_id` string
      - `settlement_type` string
      - `amount` string
      - `status` string
      - `tx_hash` string
      - `confirmed_at` string
    - `backpay_amount` string: September formula one-time hurdle backpay credited to this week, if any (see SettleAffiliateBackpayIfEligible). Claimable total for this row is earned_amount + backpay_amount, not earned_amount alone.
  - `total` string, int64
  - `limit` integer
  - `offset` integer

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/affiliate-payouts/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)