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

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

Returns a paginated list of commission records in your organization.

## Authentication

Requires a Bearer token in the `Authorization` header.

## Parameters

- `affiliate_id` (query): string (uuid) - Filter by affiliate UUID
- `payout_status` (query): string - one of: `not_paid`, `paid` - Filter by payout status
- `payout_id` (query): string (uuid) - Filter by payout UUID. Returns only commissions included in the specified payout.
- `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)**