Fans
List Expired Fans
Get a paginated list of expired fans for an Account. Newest fans are first.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
limit?string | null
Number of fans to return (1-50)
offset?string | null
Number of fans to skip
type?string | null
Filter by fan type
filter?object
Empty Object
filter.online?string | null
Filter by online status (1 for online)
filter.total_spent?string | null
Filter by minimum total spent
filter.tips?string | null
Filter by minimum tips
filter.duration?string | null
Filter by minimum subscription duration (days)
Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/fans/expired?limit=20&offset=0&type=expired&filter=&filter.online=1&filter.total_spent=100&filter.tips=50&filter.duration=30"{
"data": {
"list": [
{
"view": "x",
"avatar": "https://public.onlyfans.com/files/i/i2/i25/.../123/avatar.jpg",
"avatarThumbs": {
"c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/i/i2/i25/.../123/avatar.jpg",
"c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/i/i2/i25/.../123/avatar.jpg"
},
"header": "https://public.onlyfans.com/files/c/cs/cse/.../123/header_image.jpg",
"headerSize": {
"width": 4386,
"height": 1224
},
"headerThumbs": {
"w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/c/cs/cse/.../123/header_image.jpg",
"w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/c/cs/cse/.../123/header_image.jpg"
},
"id": 123,
"name": "name",
"username": "username",
"canLookStory": true,
"canCommentStory": true,
"hasNotViewedStory": true,
"isVerified": true,
"canPayInternal": true,
"hasScheduledStream": false,
"hasStream": false,
"hasStories": true,
"tipsEnabled": true,
"tipsTextEnabled": true,
"tipsMin": 5,
"tipsMinInternal": 1,
"tipsMax": 200,
"canEarn": true,
"canAddSubscriber": true,
"subscribePrice": 12.99,
"subscriptionBundles": [
{
"id": 123,
"discount": 50,
"duration": 3,
"price": 19.49,
"canBuy": true
}
],
"displayName": "",
"notice": "",
"isPaywallRequired": true,
"isRestricted": false,
"canRestrict": true,
"subscribedBy": true,
"subscribedByExpire": false,
"subscribedByExpireDate": "2025-01-01T00:00:00+00:00",
"subscribedByAutoprolong": false,
"subscribedIsExpiredNow": false,
"currentSubscribePrice": 0,
"subscribedOn": null,
"subscribedOnExpiredNow": true,
"subscribedOnDuration": "7 days",
"listsStates": [
{
"id": "following",
"type": "following",
"name": "Following",
"hasUser": true,
"canAddUser": false,
"cannotAddUserReason": "ALREADY_EXISTS"
},
{
"id": "fans",
"type": "fans",
"name": "Fans",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": null
},
{
"id": "recent",
"type": "recent",
"name": "Recent (last 24 hours)",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "SYSTEM_LIST"
},
{
"id": "tagged",
"type": "tagged",
"name": "Tagged",
"hasUser": true,
"canAddUser": false,
"cannotAddUserReason": "ALREADY_EXISTS"
},
{
"id": "friends",
"type": "friends",
"name": "Friends",
"hasUser": false,
"canAddUser": true,
"cannotAddUserReason": null
},
{
"id": "muted",
"type": "muted",
"name": "Muted",
"hasUser": false,
"canAddUser": true,
"cannotAddUserReason": null
}
],
"canReport": true,
"canReceiveChatMessage": true,
"hideChat": false,
"lastSeen": "2025-01-01T00:00:00+00:00",
"isPerformer": true,
"isRealPerformer": true,
"subscribedByData": {
"price": 0,
"newPrice": 0,
"regularPrice": 12.99,
"subscribePrice": 12.99,
"discountPercent": 0,
"discountPeriod": 1,
"subscribeAt": "2025-01-01T00:00:00+00:00",
"expiredAt": "2025-01-01T00:00:00+00:00",
"renewedAt": null,
"discountFinishedAt": null,
"discountStartedAt": null,
"status": "Set to Expire",
"isMuted": false,
"unsubscribeReason": "No reason given",
"duration": "2 months",
"showPostsInFeed": true,
"subscribes": [
{
"id": 123,
"userId": 123,
"subscriberId": 123,
"date": "2025-01-01T00:00:00+00:00",
"duration": 360,
"startDate": "2025-01-01T00:00:00+00:00",
"expireDate": "2025-01-01T00:00:00+00:00",
"cancelDate": null,
"price": 0,
"regularPrice": 12.99,
"discount": 0,
"earningId": 0,
"action": "subscribe",
"type": "trial",
"offerStart": "2025-01-01T00:00:00+00:00",
"offerEnd": null,
"isCurrent": true
}
],
"hasActivePaidSubscriptions": false
},
"subscribedOnData": {
"price": 0,
"newPrice": 0,
"regularPrice": 0,
"subscribePrice": 0,
"discountPercent": 0,
"discountPeriod": 1,
"subscribeAt": "2025-01-01T00:00:00+00:00",
"expiredAt": "2025-01-01T00:00:00+00:00",
"renewedAt": null,
"discountFinishedAt": null,
"discountStartedAt": null,
"status": null,
"isMuted": false,
"unsubscribeReason": "No reason given",
"duration": "7 days",
"tipsSumm": 0,
"subscribesSumm": 0,
"messagesSumm": 0,
"postsSumm": 0,
"streamsSumm": 0,
"totalSumm": 0,
"lastActivity": "2025-01-01T00:00:00+00:00",
"recommendations": 0,
"subscribes": [],
"hasActivePaidSubscriptions": false
},
"canTrialSend": false,
"isBlocked": false,
"promoOffers": [],
"canUnsubscribe": true,
"isPendingAutoprolong": false
}
],
"hasMore": true
},
"_pagination": {
"next_page": null
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999838,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 10000000,
"limit_day": 50000,
"remaining_minute": 9999999,
"remaining_day": 49996
}
}
}