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

# List affiliates

`GET /affiliates`

## Request

- Base URL: `https://refgrow.com/api/v1`
- URL: `https://refgrow.com/api/v1/affiliates`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'active' | 'inactive' | 'pending' | 'suspended'
- `sort` 'earnings' | 'unpaid' | 'purchases' | 'clicks' | 'newest'

## Response `200`

Paginated list of affiliates

- object
  - `success` boolean
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer
    - `has_more` boolean
  - `data` Affiliate[]
    - `id` integer
    - `user_email` string, email
    - `referral_code` string
    - `partner_slug` string, nullable
    - `status` 'active' | 'inactive' | 'pending' | 'suspended'
    - `clicks` integer
    - `signups` integer
    - `purchases` integer
    - `total_earnings` string
    - `unpaid_earnings` string
    - `payment_method` string, nullable
    - `payment_details` string, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid Bearer key

---

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