The Only API docs
Misc

List referrals

Returns the current user's referrals over a date range with pagination. The dynamic path segment is a built querystring. OnlyFans only — Fansly accounts are rejected on…

GET
/api2/v2/users/me/referrals

Returns the current user's referrals over a date range with pagination. The dynamic path segment is a built querystring. OnlyFans only — Fansly accounts are rejected on /api2/v2/*.

Verified live against a real OnlyFans account (2026-07-30); the data schema below is the real response shape.

Guide: The two surfaces

X-API-Key<token>

Your CRM panel API key

In: header

Query Parameters

startDate?string

Start of the date range

endDate?string

End of the date range

offset?string

Pagination offset

marker?string

Pagination marker

onlyPerformers?string

Only referred performers/creators

Header Parameters

user-id*string

Creator account ID of the account to act as (e.g. 509955039). Required — omitting it returns 400 user-id header is required. Use GET /accounts to list your connected accounts. On /api2/v2/* the account must be an OnlyFans account; Fansly accounts are rejected there.

X-Proxy?string

Proxy URL — HTTP or SOCKS5 (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Optional on post-connection routes, where it overrides the proxy saved at login time. Required on the connection routes (POST /accounts/login, POST /accounts/login/cookies, POST /accounts/login/verify-otp) for OnlyFans accounts; optional for Fansly.

Response Body

application/json

curl -X GET "https://example.com/api2/v2/users/me/referrals" \  -H "user-id: 509955039"
{  "success": true,  "status_code": 0,  "data": {    "hasMore": true,    "list": []  }}