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

# List affiliates

`GET /admin/affiliates`

## Request

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

List affiliates, filterable by search/qualified, offset-paginated (internal).

## Query parameters

- `search` string
- `qualified` boolean
- `limit` integer
- `offset` integer
- `below_tier` boolean

## Response `200`

A successful response.

- ApiListAffiliatesResponse
  - `affiliates` ApiAffiliateAdminDto[]
    - `address` string
    - `name` string
    - `tier_id` integer
    - `qualified` boolean
    - `rolling_30d_volume` string
    - `updated_at` string
    - `below_tier_since` string: RFC3339 UTC; set when the daily job has frozen this affiliate below their current tier instead of auto-downgrading (unset = not flagged).
    - `blocked_at` string: RFC3339 UTC; set when an admin has blocked this affiliate (unset = not blocked).
    - `blocked_reason` string
  - `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/affiliates/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)