OnlyFansBlocked / Restricted Users
List Blocked Users
Get a paginated list of users the account has blocked. Optionally search with query.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
account*string
The Account ID
Query Parameters
limit?integer
Number of users to return per page (1-50). Must be at least 1. Must not be greater than 50.
offset?integer
Number of users to skip for pagination. Must be at least 0.
query?string|null
Search within the user name or username.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/users/blocked?limit=10&offset=0"{
"data": {
"list": [
{
"view": "x",
"avatar": "https://public.onlyfans.com/files/example/200000001/avatar.jpg",
"avatarThumbs": {
"c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/example/200000001/avatar.jpg",
"c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/example/200000001/avatar.jpg"
},
"header": "https://public.onlyfans.com/files/example/200000001/header_image.jpg",
"headerSize": {
"width": 4028,
"height": 1250
},
"headerThumbs": {
"w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/example/200000001/header_image.jpg",
"w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/example/200000001/header_image.jpg"
},
"id": 200000001,
"name": "Example User",
"username": "exampleuser",
"canLookStory": false,
"canCommentStory": false,
"hasNotViewedStory": false,
"isVerified": true,
"canPayInternal": false,
"hasScheduledStream": false,
"hasStream": false,
"hasStories": false,
"tipsEnabled": false,
"tipsTextEnabled": true,
"tipsMin": 5,
"tipsMinInternal": 1,
"tipsMax": 200,
"canEarn": true,
"canAddSubscriber": false,
"subscribePrice": 0,
"isPaywallRequired": true,
"isActive": true,
"isRestricted": false,
"canRestrict": true,
"subscribedBy": false,
"subscribedByExpire": null,
"subscribedByExpireDate": null,
"subscribedByAutoprolong": null,
"subscribedIsExpiredNow": null,
"currentSubscribePrice": null,
"subscribedOn": false,
"subscribedOnExpire": null,
"subscribedOnExpiredNow": null,
"subscribedOnDuration": null,
"listsStates": [
{
"id": "following",
"type": "following",
"name": "Following",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "SYSTEM_LIST"
},
{
"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": "muted",
"type": "muted",
"name": "Muted",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "ALREADY_EXISTS"
}
],
"canReport": false,
"canReceiveChatMessage": false,
"hideChat": false,
"lastSeen": "2026-06-26T16:17:08+00:00",
"isPerformer": true,
"isRealPerformer": true,
"subscribedByData": null,
"subscribedOnData": null,
"canTrialSend": false,
"isBlocked": true,
"promoOffers": []
}
],
"hasMore": true,
"nextOffset": 10
},
"_pagination": {
"next_page": "https://app.onlyfansapi.com/api/acct_abc123/users/blocked?offset=10&limit=10"
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999839,
"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": 49997
}
}
}