curl --request GET \
--url https://api.onlyx.ai/v1/fans/{fanId}/purchases \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fans/{fanId}/purchases"
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}/purchases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));List a fan's purchases
Returns what a fan has bought from the creator, newest first: paid-message unlocks (with the message id) and tips, each with the amount in cents. Sales the AI made, sales your team made and unlocks bought on OnlyFans directly are all included; refunded sales are not. Use it to see what a fan already owns before offering something. Subscription payments are in the creator’s transaction ledger (GET /v1/creators/{creatorId}/transactions).
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}/purchases \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fans/{fanId}/purchases"
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}/purchases', 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.
40Query Parameters
Page size, 1-100. Default 25.
1 <= x <= 100Opaque cursor from the previous page's nextCursor. Omit for the first page.
1024