> ## 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 User Lists (/api-reference/user-list-collections/list-user-lists)

Get a list of OnlyFans Collections - User Lists

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/user-lists
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: 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 and tracking 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}/user-lists:
    parameters:
      - in: path
        name: account
        description: The Account ID
        example: acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List User Lists
      operationId: listUserLists
      description: Get a list of OnlyFans Collections - User Lists
      parameters:
        - in: query
          name: limit
          description: How many results to return in the request. Max. 50 user lists. Must
            be at least 10. Must not be greater than 50.
          example: 10
          required: false
          schema:
            type: integer
            description: How many results to return in the request. Max. 50 user lists. Must
              be at least 10. Must not be greater than 50.
            example: 10
            nullable: true
        - in: query
          name: offset
          description: Must be at least 0.
          example: 0
          required: false
          schema:
            type: integer
            description: Must be at least 0.
            example: 0
            nullable: true
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - id: recent
                      type: recent
                      name: Recent (last 24 hours)
                      usersCount: 0
                      postsCount: 362
                      order: default
                      direction: asc
                      canUpdate: false
                      canDelete: false
                      canManageUsers: false
                      canAddUsers: false
                      canPinnedToFeed: false
                      isPinnedToFeed: false
                      canPinnedToChat: false
                      isPinnedToChat: false
                      sortList: []
                      users: []
                    - id: following
                      type: following
                      name: Following
                      usersCount: 1565
                      postsCount: 302925
                      order: last_activity
                      direction: desc
                      canUpdate: false
                      canDelete: false
                      canManageUsers: false
                      canAddUsers: false
                      canPinnedToFeed: false
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList:
                        expired:
                          order: is_expired
                          direction: desc
                      users:
                        - view: t
                          id: 13760776
                          name: User 1
                          username: user001
                          isVerified: true
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 20385509
                          name: User 2
                          username: user002
                          isVerified: true
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 21272634
                          name: User 3
                          username: user003
                          isVerified: true
                          avatar: null
                          avatarThumbs: null
                    - id: 1139401260
                      type: custom
                      name: Test List
                      usersCount: 7
                      postsCount: 0
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 90986491
                          name: User 4
                          username: user004
                          isVerified: false
                          avatar: https://example.com/avatar1.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar1_c50.jpg
                            c144: https://example.com/avatar1_c144.jpg
                        - view: t
                          id: 179686216
                          name: User 5
                          username: user005
                          isVerified: false
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 215265232
                          name: User 6
                          username: user006
                          isVerified: false
                          avatar: null
                          avatarThumbs: null
                    - id: 1015359034
                      type: custom
                      name: Sample List
                      usersCount: 1
                      postsCount: 29
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 254
                          name: Official Account
                          username: official_account
                          isVerified: true
                          avatar: https://example.com/official_avatar.jpg
                          avatarThumbs:
                            c50: https://example.com/official_avatar_c50.jpg
                            c144: https://example.com/official_avatar_c144.jpg
                    - id: 1196977344
                      type: custom
                      name: Custom List 1
                      usersCount: 3
                      postsCount: 10
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 501222911
                          name: User 7
                          username: user007
                          isVerified: true
                          avatar: https://example.com/avatar2.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar2_c50.jpg
                            c144: https://example.com/avatar2_c144.jpg
                        - view: t
                          id: 501239164
                          name: User 8
                          username: user008
                          isVerified: true
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 501239274
                          name: User 9
                          username: user009
                          isVerified: true
                          avatar: https://example.com/avatar3.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar3_c50.jpg
                            c144: https://example.com/avatar3_c144.jpg
                    - id: 1030408500
                      type: custom
                      name: Custom List 2
                      usersCount: 3
                      postsCount: 253
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 11317639
                          name: User 10
                          username: user010
                          isVerified: false
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 333848388
                          name: User 11
                          username: user011
                          isVerified: false
                          avatar: null
                          avatarThumbs: null
                        - view: t
                          id: 343871698
                          name: User 12
                          username: user012
                          isVerified: true
                          avatar: https://example.com/avatar4.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar4_c50.jpg
                            c144: https://example.com/avatar4_c144.jpg
                    - id: 1197226753
                      type: custom
                      name: Custom List 3
                      usersCount: 3
                      postsCount: 2
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 501239695
                          name: User 13
                          username: user013
                          isVerified: true
                          avatar: https://example.com/avatar5.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar5_c50.jpg
                            c144: https://example.com/avatar5_c144.jpg
                        - view: t
                          id: 501239827
                          name: User 14
                          username: user014
                          isVerified: true
                          avatar: https://example.com/avatar6.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar6_c50.jpg
                            c144: https://example.com/avatar6_c144.jpg
                        - view: t
                          id: 501240489
                          name: User 15
                          username: user015
                          isVerified: true
                          avatar: https://example.com/avatar7.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar7_c50.jpg
                            c144: https://example.com/avatar7_c144.jpg
                    - id: 1197228713
                      type: custom
                      name: Empty List
                      usersCount: 0
                      postsCount: 0
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users: []
                    - id: 1015361366
                      type: custom
                      name: Custom List 4
                      usersCount: 4
                      postsCount: 0
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users:
                        - view: t
                          id: 234451987
                          name: User 16
                          username: user016
                          isVerified: false
                          avatar: https://example.com/avatar8.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar8_c50.jpg
                            c144: https://example.com/avatar8_c144.jpg
                        - view: t
                          id: 240164795
                          name: User 17
                          username: user017
                          isVerified: false
                          avatar: https://example.com/avatar9.jpg
                          avatarThumbs:
                            c50: https://example.com/avatar9_c50.jpg
                            c144: https://example.com/avatar9_c144.jpg
                        - view: t
                          id: 279118217
                          name: User 18
                          username: user018
                          isVerified: false
                          avatar: null
                          avatarThumbs: null
                    - id: 1015359887
                      type: custom
                      name: Another Empty List
                      usersCount: 0
                      postsCount: 0
                      order: default
                      direction: asc
                      canUpdate: true
                      canDelete: true
                      canManageUsers: true
                      canAddUsers: true
                      canPinnedToFeed: true
                      isPinnedToFeed: false
                      canPinnedToChat: true
                      isPinnedToChat: false
                      sortList: []
                      users: []
                  _meta:
                    _credits:
                      used: 1
                      balance: 224858
                      note: Always
                    _cache:
                      is_cached: false
                      note: Cache disabled for this endpoint
                    _rate_limits:
                      limit_minute: 1000
                      limit_day: 50000
                      remaining_minute: 998
                      remaining_day: 49991
                properties:
                  data:
                    type: array
                    example:
                      - id: recent
                        type: recent
                        name: Recent (last 24 hours)
                        usersCount: 0
                        postsCount: 362
                        order: default
                        direction: asc
                        canUpdate: false
                        canDelete: false
                        canManageUsers: false
                        canAddUsers: false
                        canPinnedToFeed: false
                        isPinnedToFeed: false
                        canPinnedToChat: false
                        isPinnedToChat: false
                        sortList: []
                        users: []
                      - id: following
                        type: following
                        name: Following
                        usersCount: 1565
                        postsCount: 302925
                        order: last_activity
                        direction: desc
                        canUpdate: false
                        canDelete: false
                        canManageUsers: false
                        canAddUsers: false
                        canPinnedToFeed: false
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList:
                          expired:
                            order: is_expired
                            direction: desc
                        users:
                          - view: t
                            id: 13760776
                            name: User 1
                            username: user001
                            isVerified: true
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 20385509
                            name: User 2
                            username: user002
                            isVerified: true
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 21272634
                            name: User 3
                            username: user003
                            isVerified: true
                            avatar: null
                            avatarThumbs: null
                      - id: 1139401260
                        type: custom
                        name: Test List
                        usersCount: 7
                        postsCount: 0
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 90986491
                            name: User 4
                            username: user004
                            isVerified: false
                            avatar: https://example.com/avatar1.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar1_c50.jpg
                              c144: https://example.com/avatar1_c144.jpg
                          - view: t
                            id: 179686216
                            name: User 5
                            username: user005
                            isVerified: false
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 215265232
                            name: User 6
                            username: user006
                            isVerified: false
                            avatar: null
                            avatarThumbs: null
                      - id: 1015359034
                        type: custom
                        name: Sample List
                        usersCount: 1
                        postsCount: 29
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 254
                            name: Official Account
                            username: official_account
                            isVerified: true
                            avatar: https://example.com/official_avatar.jpg
                            avatarThumbs:
                              c50: https://example.com/official_avatar_c50.jpg
                              c144: https://example.com/official_avatar_c144.jpg
                      - id: 1196977344
                        type: custom
                        name: Custom List 1
                        usersCount: 3
                        postsCount: 10
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 501222911
                            name: User 7
                            username: user007
                            isVerified: true
                            avatar: https://example.com/avatar2.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar2_c50.jpg
                              c144: https://example.com/avatar2_c144.jpg
                          - view: t
                            id: 501239164
                            name: User 8
                            username: user008
                            isVerified: true
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 501239274
                            name: User 9
                            username: user009
                            isVerified: true
                            avatar: https://example.com/avatar3.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar3_c50.jpg
                              c144: https://example.com/avatar3_c144.jpg
                      - id: 1030408500
                        type: custom
                        name: Custom List 2
                        usersCount: 3
                        postsCount: 253
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 11317639
                            name: User 10
                            username: user010
                            isVerified: false
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 333848388
                            name: User 11
                            username: user011
                            isVerified: false
                            avatar: null
                            avatarThumbs: null
                          - view: t
                            id: 343871698
                            name: User 12
                            username: user012
                            isVerified: true
                            avatar: https://example.com/avatar4.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar4_c50.jpg
                              c144: https://example.com/avatar4_c144.jpg
                      - id: 1197226753
                        type: custom
                        name: Custom List 3
                        usersCount: 3
                        postsCount: 2
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 501239695
                            name: User 13
                            username: user013
                            isVerified: true
                            avatar: https://example.com/avatar5.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar5_c50.jpg
                              c144: https://example.com/avatar5_c144.jpg
                          - view: t
                            id: 501239827
                            name: User 14
                            username: user014
                            isVerified: true
                            avatar: https://example.com/avatar6.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar6_c50.jpg
                              c144: https://example.com/avatar6_c144.jpg
                          - view: t
                            id: 501240489
                            name: User 15
                            username: user015
                            isVerified: true
                            avatar: https://example.com/avatar7.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar7_c50.jpg
                              c144: https://example.com/avatar7_c144.jpg
                      - id: 1197228713
                        type: custom
                        name: Empty List
                        usersCount: 0
                        postsCount: 0
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users: []
                      - id: 1015361366
                        type: custom
                        name: Custom List 4
                        usersCount: 4
                        postsCount: 0
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users:
                          - view: t
                            id: 234451987
                            name: User 16
                            username: user016
                            isVerified: false
                            avatar: https://example.com/avatar8.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar8_c50.jpg
                              c144: https://example.com/avatar8_c144.jpg
                          - view: t
                            id: 240164795
                            name: User 17
                            username: user017
                            isVerified: false
                            avatar: https://example.com/avatar9.jpg
                            avatarThumbs:
                              c50: https://example.com/avatar9_c50.jpg
                              c144: https://example.com/avatar9_c144.jpg
                          - view: t
                            id: 279118217
                            name: User 18
                            username: user018
                            isVerified: false
                            avatar: null
                            avatarThumbs: null
                      - id: 1015359887
                        type: custom
                        name: Another Empty List
                        usersCount: 0
                        postsCount: 0
                        order: default
                        direction: asc
                        canUpdate: true
                        canDelete: true
                        canManageUsers: true
                        canAddUsers: true
                        canPinnedToFeed: true
                        isPinnedToFeed: false
                        canPinnedToChat: true
                        isPinnedToChat: false
                        sortList: []
                        users: []
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: recent
                        type:
                          type: string
                          example: recent
                        name:
                          type: string
                          example: Recent (last 24 hours)
                        usersCount:
                          type: integer
                          example: 0
                        postsCount:
                          type: integer
                          example: 362
                        order:
                          type: string
                          example: default
                        direction:
                          type: string
                          example: asc
                        canUpdate:
                          type: boolean
                          example: false
                        canDelete:
                          type: boolean
                          example: false
                        canManageUsers:
                          type: boolean
                          example: false
                        canAddUsers:
                          type: boolean
                          example: false
                        canPinnedToFeed:
                          type: boolean
                          example: false
                        isPinnedToFeed:
                          type: boolean
                          example: false
                        canPinnedToChat:
                          type: boolean
                          example: false
                        isPinnedToChat:
                          type: boolean
                          example: false
                        sortList:
                          type: array
                          example: []
                        users:
                          type: array
                          example: []
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 224858
                          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: 1000
                          limit_day:
                            type: integer
                            example: 50000
                          remaining_minute:
                            type: integer
                            example: 998
                          remaining_day:
                            type: integer
                            example: 49991
      tags:
        - User List Collections
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````