List Subscribers
List the users holding a subscription to the creator, with each subscription's status, price in USD cents, current period end and auto-renew flag. For the subscribers about to lapse, use List Expiring Subscribers rather than paging this endpoint and filtering on subscription.currentPeriodEnd and subscription.autoRenewalEnabled yourself.
Proxies Fanvue's GET /v1/subscribers and returns its body unchanged. The nextCursor carries the sort and date range the first page was cut under, so later pages need nothing but the cursor.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fanvue Account ID
Query Parameters
Opaque pagination cursor from a previous response's nextCursor.
Number of subscribers to return (1 - 50). Default = 15
Field to sort by: name or subscribedAt. Default = subscribedAt
Sort direction: asc or desc. Default = desc for subscribedAt, asc for name
Only include subscriptions started on or after this ISO 8601 datetime.
Only include subscriptions started before this ISO 8601 datetime (non-inclusive).
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fanvue/fanvue_acct_XXXXXXXXXXXXXXX/fans/subscribers?cursor=eyJ2IjoxfQ&size=15&sortField=subscribedAt&sortDirection=desc&startDate=2026-01-01T00%3A00%3A00Z&endDate=2026-09-01T00%3A00%3A00Z"{
"data": {
"data": [
{
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"handle": "sarah-jones",
"displayName": "Sarah Jones",
"nickname": null,
"isTopSpender": false,
"avatarUrl": null,
"registeredAt": "2026-09-21T12:05:33.176Z",
"subscription": {
"status": "active",
"price": 399,
"amountPaid": 399,
"currentPeriodStart": "2026-09-22T10:29:07.224Z",
"currentPeriodEnd": "2026-10-22T10:28:59.873Z",
"autoRenewalEnabled": true
},
"firstSubscribedAt": "2026-09-22T10:29:07.474Z"
}
],
"nextCursor": null
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055811,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}