---
title: "List the affiliate referrals"
method: GET
path: "/affiliate/referrals/"
tags: ["affiliate"]
---

# List the affiliate referrals

`GET /affiliate/referrals/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/affiliate/referrals/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The affiliate's referrals with the terms and money attached to each, newest first. Anonymous by design, like the feed: a row says what a referral pays and under which stamped rate, never who it is.

## Query parameters

- `limit` integer: Maximum rows returned.

## Response `200`

Successful Response

- AffiliateReferralReadSchema[]
  - `clawed_back_cents` integer, required: What refunds and disputes took back off it, as a positive magnitude.
  - `commission_months` integer, required: How many months this referral pays commission for.
  - `commission_rate_bps` integer, required: The rate stamped on THIS referral, which the program's current offer does not change.
  - `commission_window_ends_at` string, date-time, nullable, required: When this referral stops earning; null until it converts.
  - `converted_at` string, date-time, nullable, required: When this referral first started paying; null while still on the free plan.
  - `earned_cents` integer, required: Gross commission this referral has produced.
  - `id` string, uuid, required
  - `last_payment_at` string, date-time, nullable, required
  - `payment_count` integer, required: How many commission payments it has produced.
  - `signed_up_at` string, date-time, required
  - `source` string, required: The link tag this referral arrived under, if any.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)