> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Restricted Users (/api-reference/blocked-restricted-users/list-restricted-users)

Get a paginated list of users the account has restricted. Optionally search with `query`.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/users/restricted
openapi: 3.0.3
info:
  title: OnlyFans API
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: API Keys
    description: ""
  - name: Account
    description: Endpoints for your linked accounts
  - name: Analytics - Financial
    description: APIs for retrieving financial analytics data
  - name: Analytics - Summary
    description: APIs for retrieving summary analytics data
  - name: Banking
    description: Operations related to user banking details, payout methods, legal
      and tax information, and account country settings.
  - name: Blocked / Restricted Users
    description: APIs for listing the users an account has blocked or restricted
  - name: Chargebacks
    description: ""
  - name: Chat Messages
    description: ""
  - name: Chats
    description: ""
  - name: Client Sessions
    description: ""
  - name: Connect OnlyFans Account
    description: ""
  - name: Data Exports
    description: APIs for managing data exports
  - name: Engagement / Messages
    description: ""
  - name: Fans
    description: APIs for managing OnlyFans fans (subscribers)
  - name: Fans - AI Summary
    description: APIs for generating and retrieving AI-powered fan profile summaries
  - name: Following
    description: APIs for managing OnlyFans followings (people you're subscribed to)
  - name: Free Trial Links
    description: APIs for managing Free Trial Links
  - name: Giphy
    description: ""
  - name: Link Tags
    description: APIs for managing tags on free trial links, tracking links, and Smart Links
  - name: Mass Messaging
    description: ""
  - name: Media
    description: ""
  - name: Media Vault
    description: ""
  - name: Media Vault Lists
    description: ""
  - name: Notifications
    description: Endpoints for managingr account notifications
  - name: Payouts
    description: ""
  - name: Post Comments
    description: ""
  - name: Post Labels
    description: APIs for managing your post labels
  - name: Posts
    description: APIs for managing OnlyFans posts
  - name: Promotions
    description: ""
  - name: Public Profiles
    description: ""
  - name: Queue
    description: ""
  - name: Release Forms
    description: APIs for managing OnlyFans release forms
  - name: Saved For Later (Messages)
    description: ""
  - name: Saved For Later (Posts)
    description: ""
  - name: Settings
    description: ""
  - name: Shared Free Trial Links
    description: APIs for Free Trial Links that other OF creators have shared with
      this account. Revenue, cost, and spender data are not available for shared
      links.
  - name: Shared Tracking Links
    description: APIs for Tracking Links (campaigns) that other OF creators have
      shared with this account. Revenue, cost, and spender data are not
      available for shared campaigns.
  - name: Smart Link Postbacks
    description: APIs for managing Smart Link postback destinations
  - name: Smart Links
    description: APIs for managing Smart Links (Free Trial Links and Tracking Links
      with pooled inventory)
  - name: Statistics
    description: ""
  - name: Stored Free Trial Links
    description: Instant APIs for retrieving stored free trial links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Free Trial Links
    description: Instant APIs for retrieving stored shared Free Trial Links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Tracking Links
    description: Instant APIs for retrieving stored shared Tracking Links
      (campaigns) from the OnlyFansAPI Cache (free, no credits used)
  - name: Stored Tracking Links
    description: Instant APIs for retrieving stored tracking links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stories
    description: APIs for managing OnlyFans stories
  - name: Story Highlights
    description: APIs for managing OnlyFans story highlights
  - name: Subscription Bundles
    description: ""
  - name: Tracking Links
    description: APIs for managing tracking links
  - name: Transactions
    description: APIs for managing OnlyFans transactions
  - name: User List Collections
    description: ""
  - name: Users
    description: APIs for fetching OnlyFans users
  - name: Webhooks
    description: ""
paths:
  /api/{account}/users/restricted:
    parameters:
      - in: path
        name: account
        description: The Account ID
        example: acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List Restricted Users
      operationId: listRestrictedUsers
      description: Get a paginated list of users the account has restricted.
        Optionally search with `query`.
      parameters:
        - in: query
          name: limit
          description: Number of users to return per page (1-50). Must be at least 1. Must
            not be greater than 50.
          example: 10
          required: false
          schema:
            type: integer
            description: Number of users to return per page (1-50). Must be at least 1. Must
              not be greater than 50.
            example: 10
        - in: query
          name: offset
          description: Number of users to skip for pagination. Must be at least 0.
          example: 0
          required: false
          schema:
            type: integer
            description: Number of users to skip for pagination. Must be at least 0.
            example: 0
        - in: query
          name: query
          description: Search within the user name or username.
          example: null
          required: false
          schema:
            type: string
            description: Search within the user name or username.
            example: null
            nullable: true
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    list:
                      - view: x
                        avatar: https://public.onlyfans.com/files/example/200000002/avatar.jpg
                        avatarThumbs:
                          c50: https://thumbs.onlyfans.com/public/files/thumbs/c50/example/200000002/avatar.jpg
                          c144: https://thumbs.onlyfans.com/public/files/thumbs/c144/example/200000002/avatar.jpg
                        header: https://public.onlyfans.com/files/example/200000002/header_image.jpg
                        headerSize:
                          width: 4028
                          height: 1250
                        headerThumbs:
                          w480: https://thumbs.onlyfans.com/public/files/thumbs/w480/example/200000002/header_image.jpg
                          w760: https://thumbs.onlyfans.com/public/files/thumbs/w760/example/200000002/header_image.jpg
                        id: 200000002
                        name: Another User
                        username: anotheruser
                        canLookStory: false
                        canCommentStory: false
                        hasNotViewedStory: false
                        isVerified: true
                        canPayInternal: true
                        hasScheduledStream: false
                        hasStream: false
                        hasStories: false
                        tipsEnabled: false
                        tipsTextEnabled: false
                        tipsMin: 5
                        tipsMinInternal: 1
                        tipsMax: 200
                        canEarn: true
                        canAddSubscriber: true
                        subscribePrice: 0
                        isPaywallRequired: true
                        isActive: true
                        isRestricted: true
                        canRestrict: false
                        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: true
                            cannotAddUserReason: null
                        canReport: false
                        canReceiveChatMessage: false
                        hideChat: false
                        lastSeen: 2026-06-26T16:37:48+00:00
                        isPerformer: true
                        isRealPerformer: true
                        subscribedByData: null
                        subscribedOnData: null
                        canTrialSend: false
                        isBlocked: false
                    hasMore: true
                    nextOffset: 10
                  _pagination:
                    next_page: https://app.onlyfansapi.com/api/acct_abc123/users/restrict?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
                properties:
                  data:
                    type: object
                    properties:
                      list:
                        type: array
                        example:
                          - view: x
                            avatar: https://public.onlyfans.com/files/example/200000002/avatar.jpg
                            avatarThumbs:
                              c50: https://thumbs.onlyfans.com/public/files/thumbs/c50/example/200000002/avatar.jpg
                              c144: https://thumbs.onlyfans.com/public/files/thumbs/c144/example/200000002/avatar.jpg
                            header: https://public.onlyfans.com/files/example/200000002/header_image.jpg
                            headerSize:
                              width: 4028
                              height: 1250
                            headerThumbs:
                              w480: https://thumbs.onlyfans.com/public/files/thumbs/w480/example/200000002/header_image.jpg
                              w760: https://thumbs.onlyfans.com/public/files/thumbs/w760/example/200000002/header_image.jpg
                            id: 200000002
                            name: Another User
                            username: anotheruser
                            canLookStory: false
                            canCommentStory: false
                            hasNotViewedStory: false
                            isVerified: true
                            canPayInternal: true
                            hasScheduledStream: false
                            hasStream: false
                            hasStories: false
                            tipsEnabled: false
                            tipsTextEnabled: false
                            tipsMin: 5
                            tipsMinInternal: 1
                            tipsMax: 200
                            canEarn: true
                            canAddSubscriber: true
                            subscribePrice: 0
                            isPaywallRequired: true
                            isActive: true
                            isRestricted: true
                            canRestrict: false
                            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: true
                                cannotAddUserReason: null
                            canReport: false
                            canReceiveChatMessage: false
                            hideChat: false
                            lastSeen: 2026-06-26T16:37:48+00:00
                            isPerformer: true
                            isRealPerformer: true
                            subscribedByData: null
                            subscribedOnData: null
                            canTrialSend: false
                            isBlocked: false
                        items:
                          type: object
                          properties:
                            view:
                              type: string
                              example: x
                            avatar:
                              type: string
                              example: https://public.onlyfans.com/files/example/200000002/avatar.jpg
                            avatarThumbs:
                              type: object
                              properties:
                                c50:
                                  type: string
                                  example: https://thumbs.onlyfans.com/public/files/thumbs/c50/example/200000002/avatar.jpg
                                c144:
                                  type: string
                                  example: https://thumbs.onlyfans.com/public/files/thumbs/c144/example/200000002/avatar.jpg
                            header:
                              type: string
                              example: https://public.onlyfans.com/files/example/200000002/header_image.jpg
                            headerSize:
                              type: object
                              properties:
                                width:
                                  type: integer
                                  example: 4028
                                height:
                                  type: integer
                                  example: 1250
                            headerThumbs:
                              type: object
                              properties:
                                w480:
                                  type: string
                                  example: https://thumbs.onlyfans.com/public/files/thumbs/w480/example/200000002/header_image.jpg
                                w760:
                                  type: string
                                  example: https://thumbs.onlyfans.com/public/files/thumbs/w760/example/200000002/header_image.jpg
                            id:
                              type: integer
                              example: 200000002
                            name:
                              type: string
                              example: Another User
                            username:
                              type: string
                              example: anotheruser
                            canLookStory:
                              type: boolean
                              example: false
                            canCommentStory:
                              type: boolean
                              example: false
                            hasNotViewedStory:
                              type: boolean
                              example: false
                            isVerified:
                              type: boolean
                              example: true
                            canPayInternal:
                              type: boolean
                              example: true
                            hasScheduledStream:
                              type: boolean
                              example: false
                            hasStream:
                              type: boolean
                              example: false
                            hasStories:
                              type: boolean
                              example: false
                            tipsEnabled:
                              type: boolean
                              example: false
                            tipsTextEnabled:
                              type: boolean
                              example: false
                            tipsMin:
                              type: integer
                              example: 5
                            tipsMinInternal:
                              type: integer
                              example: 1
                            tipsMax:
                              type: integer
                              example: 200
                            canEarn:
                              type: boolean
                              example: true
                            canAddSubscriber:
                              type: boolean
                              example: true
                            subscribePrice:
                              type: integer
                              example: 0
                            isPaywallRequired:
                              type: boolean
                              example: true
                            isActive:
                              type: boolean
                              example: true
                            isRestricted:
                              type: boolean
                              example: true
                            canRestrict:
                              type: boolean
                              example: false
                            subscribedBy:
                              type: boolean
                              example: false
                            subscribedByExpire:
                              type: string
                              example: null
                              nullable: true
                            subscribedByExpireDate:
                              type: string
                              example: null
                              nullable: true
                            subscribedByAutoprolong:
                              type: string
                              example: null
                              nullable: true
                            subscribedIsExpiredNow:
                              type: string
                              example: null
                              nullable: true
                            currentSubscribePrice:
                              type: string
                              example: null
                              nullable: true
                            subscribedOn:
                              type: boolean
                              example: false
                            subscribedOnExpire:
                              type: string
                              example: null
                              nullable: true
                            subscribedOnExpiredNow:
                              type: string
                              example: null
                              nullable: true
                            subscribedOnDuration:
                              type: string
                              example: null
                              nullable: true
                            listsStates:
                              type: array
                              example:
                                - 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: true
                                  cannotAddUserReason: null
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    example: following
                                  type:
                                    type: string
                                    example: following
                                  name:
                                    type: string
                                    example: Following
                                  hasUser:
                                    type: boolean
                                    example: false
                                  canAddUser:
                                    type: boolean
                                    example: false
                                  cannotAddUserReason:
                                    type: string
                                    example: SYSTEM_LIST
                            canReport:
                              type: boolean
                              example: false
                            canReceiveChatMessage:
                              type: boolean
                              example: false
                            hideChat:
                              type: boolean
                              example: false
                            lastSeen:
                              type: string
                              example: 2026-06-26T16:37:48+00:00
                            isPerformer:
                              type: boolean
                              example: true
                            isRealPerformer:
                              type: boolean
                              example: true
                            subscribedByData:
                              type: string
                              example: null
                              nullable: true
                            subscribedOnData:
                              type: string
                              example: null
                              nullable: true
                            canTrialSend:
                              type: boolean
                              example: false
                            isBlocked:
                              type: boolean
                              example: false
                      hasMore:
                        type: boolean
                        example: true
                      nextOffset:
                        type: integer
                        example: 10
                  _pagination:
                    type: object
                    properties:
                      next_page:
                        type: string
                        example: https://app.onlyfansapi.com/api/acct_abc123/users/restrict?offset=10&limit=10
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 999999839
                          note:
                            type: string
                            example: Always
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache disabled for this endpoint
                      _rate_limits:
                        type: object
                        properties:
                          limit_minute:
                            type: integer
                            example: 10000000
                          limit_day:
                            type: integer
                            example: 50000
                          remaining_minute:
                            type: integer
                            example: 9999999
                          remaining_day:
                            type: integer
                            example: 49997
      tags:
        - Blocked / Restricted Users
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````