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

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

Returns a paginated list of payouts in your organization.

## Authentication

Requires a Bearer token in the `Authorization` header.

## Parameters

- `affiliate_id` (query): string (uuid) - Filter by affiliate UUID
- `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)**