---
title: "List affiliate commissions"
method: GET
path: "/v1/affiliates/{id}/commissions"
tags: ["Affiliates"]
---

# List affiliate commissions

`GET /v1/affiliates/{id}/commissions`

Retrieve a paginated list of an affiliate’s commissions. Filter by settlement status (pending, approved, paid).

## Path parameters

- `id` string, required

## Query parameters

- `status` 'pending' | 'approved' | 'paid' — The settlement status of the commission. `pending` while on hold, `approved` once cleared and available, `paid` once settled by a payout.
- `page_number` number
- `page_size` number

## Response `200`

Successfully retrieved affiliate commissions

- CommissionListEntity
  - `items` CommissionEntity[], required — List of commission items
    - `id` string, required — Unique identifier for the object.
    - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
    - `object` string, required — String representing the object's type. Objects of the same type share the same value.
    - `affiliate` string, required — The ID of the affiliate this commission belongs to.
    - `amount` number, required — The commission amount in cents. 1000 = $10.00
    - `currency` string, required — Three-letter ISO currency code, in uppercase, for the commission amount.
    - `status` 'pending' | 'approved' | 'paid', required — The settlement status of the commission. `pending` while on hold, `approved` once cleared and available, `paid` once settled by a payout.
    - `sale` string, nullable — The ID of the sale transaction that generated this commission, if available.
    - `created_at` number, required — Creation date of the commission as a timestamp.
  - `pagination` PaginationEntity, required
    - `total_records` number, required — Total number of records in the list
    - `total_pages` number, required — Total number of pages available
    - `current_page` number, required — The current page number
    - `next_page` number, nullable, required — The next page number, or null if there is no next page
    - `prev_page` number, nullable, required — The previous page number, or null if there is no previous page

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/versions/aa593160d96c/schema)