# List affiliates
URL: /docs/api-reference/affiliates/list-affiliates
Description: Returns a paginated list of affiliates in your organization.

**GET** `https://www.promotekit.com/api/v1/affiliates`

Returns a paginated list of affiliates in your organization.

## Authentication

Requires a Bearer token in the `Authorization` header.

## Parameters

- `campaign_id` (query): string (uuid) - Filter by campaign UUID
- `email` (query): string (email) - Filter by affiliate email. Returns 0 or 1 results.
- `ref_code` (query): string - Filter by affiliate link referral code (unique code at the end of the affiliate's link).
- `promo_code` (query): string - Filter by affiliate promo code.
- `limit` (query): integer (default: 10) - Number of records to return (default: 10, max: 100)
- `page` (query): integer (default: 1) - Page number (1-indexed)

## Responses

### 200 - Successful response

- `success`: boolean **(required)**
- `data`: array **(required)**
- `pagination`: object **(required)**

### 401 - Authentication failed

- `success`: boolean **(required)**
- `error`: object **(required)**

### 429 - Rate limit exceeded

- `success`: boolean **(required)**
- `error`: object **(required)**