curl --request GET \
--url https://api.onlyx.ai/v1/fans/{fanId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fans/{fanId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/fans/{fanId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Get a fan
Returns one fan: subscription, lifetime spend split into tips and paid messages, last activity, the creator’s fan lists they are on, your team’s custom name and notes, and salesOptOut. A fan belongs to one creator; the same person subscribed to two of your creators is two fans. A fan the credential cannot see is 404 FAN_NOT_FOUND, exactly like an id that does not exist.
Scope: requires fans:read.
Rate limit: the general limit of 120 requests per 60 seconds per credential.
curl --request GET \
--url https://api.onlyx.ai/v1/fans/{fanId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fans/{fanId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/fans/{fanId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Authorizations
An API key (onx_sk_…) created in OnlyX under Settings → API & MCP, or an OAuth access token (onx_at_…) issued to a connected app. Send it as Authorization: Bearer <credential>. API keys may also be sent as X-API-Key: <key>.
Path Parameters
The fan id (fan_…), from GET /v1/fans.
40Response
The fan.
The fan's OnlyFans avatar, when known.
The conversation with this fan, or null if there is none yet.
When OnlyX first saw this fan.
The creator this fan subscribes (or subscribed) to.
The name your team gave this fan in OnlyX. Only your team sees it.
The fan's OnlyFans display name.
The fan id (fan_…). A fan belongs to one creator.
The fan's last activity OnlyX saw (a message or a purchase).
The fan's last purchase.
The creator's fan lists this fan is on.
Show child attributes
Show child attributes
Your team's mute flag in OnlyX. It never mutes or blocks the fan on OnlyFans.
Your team's notes on this fan.
Paid-message purchases, in cents.
Whether auto-renew is on. null when OnlyFans has not said.
true when the fan asked not to be sold to. Paid messages to this fan are refused with 409 SALES_OPTED_OUT, and the AI does not sell to them.
true while the subscription is active.
When the current (or last) subscription started.
When the current subscription ends or ended.
What the fan pays per period, in cents. 0 on a free page.
Tips, in cents.
Everything the fan has spent on this creator, in cents.
The fan's OnlyFans username, when known.