> ## 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 Chats (/api-reference/fanvue/chats/list-chats)

List the creator's chats. Proxies Fanvue's `GET /v1/chats` and returns its body unchanged, including the `nextCursor` to page with and the `total` where Fanvue computes one.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/chats
openapi: 3.0.3
info:
  title: Fanvue API Documentation
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: Account
    description: Endpoints for your connected Fanvue accounts
  - name: Chat Messages
    description: Endpoints for the messages inside a Fanvue chat.
  - name: Chats
    description: Endpoints for a Fanvue creator's inbox. A chat is identified by the
      fan's user UUID.
  - name: Fans
    description: "Endpoints for the fans of a Fanvue creator: subscribers,
      followers, smart lists and per-fan insights."
  - name: Fanvue Account
    description: Endpoints for the connected Fanvue creator itself.
  - name: Insights
    description: "Revenue and growth reporting for a Fanvue creator: per-transaction
      earnings, the aggregated earnings summary, the subscriber trend and top
      spenders."
  - name: Profiles
    description: Public Fanvue creator profiles, readable without connecting the creator.
paths:
  /api/fanvue/{fanvueAccount}/chats:
    parameters:
      - in: path
        name: fanvueAccount
        description: The Fanvue Account ID
        example: fanvue_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List Chats
      operationId: listChats
      description: List the creator's chats. Proxies Fanvue's `GET /v1/chats` and
        returns its body unchanged, including the `nextCursor` to page with and
        the `total` where Fanvue computes one.
      parameters:
        - in: query
          name: cursor
          description: Opaque pagination cursor from a previous response's `nextCursor`.
          example: eyJ2IjoxfQ
          required: false
          schema:
            type: string
            description: Opaque pagination cursor from a previous response's `nextCursor`.
            example: eyJ2IjoxfQ
        - in: query
          name: size
          description: Number of chats to return (1 - 50). Default = 15
          example: 15
          required: false
          schema:
            type: integer
            description: Number of chats to return (1 - 50). Default = 15
            example: 15
        - in: query
          name: filter
          description: "Filters to apply: `unread`, `subscribers`, `followers`, `online`,
            `recent_subscribers`, `not_answered`, `spent_more_than_50`,
            `on_free_trial`, `has_tipped`, `spenders`, `exclude_creators`,
            `subscribed_to`, `not_muted`, `muted`, `archived`."
          example:
            - unread
          required: false
          schema:
            type: array
            description: "Filters to apply: `unread`, `subscribers`, `followers`, `online`,
              `recent_subscribers`, `not_answered`, `spent_more_than_50`,
              `on_free_trial`, `has_tipped`, `spenders`, `exclude_creators`,
              `subscribed_to`, `not_muted`, `muted`, `archived`."
            example:
              - unread
            items:
              type: string
        - in: query
          name: smartListIds
          description: "Fanvue smart list ids to filter by: `subscribers`,
            `auto_renewing`, `non_renewing`, `followers`,
            `free_trial_subscribers`, `expired_subscribers`,
            `spent_more_than_50`, `muted`, `creators`."
          example:
            - subscribers
          required: false
          schema:
            type: array
            description: "Fanvue smart list ids to filter by: `subscribers`,
              `auto_renewing`, `non_renewing`, `followers`,
              `free_trial_subscribers`, `expired_subscribers`,
              `spent_more_than_50`, `muted`, `creators`."
            example:
              - subscribers
            items:
              type: string
        - in: query
          name: userUuids
          description: Restrict the list to these fan user UUIDs.
          example:
            - f47ac10b-58cc-4372-a567-0e02b2c3d479
          required: false
          schema:
            type: array
            description: Restrict the list to these fan user UUIDs.
            example:
              - f47ac10b-58cc-4372-a567-0e02b2c3d479
            items:
              type: string
        - in: query
          name: customListId
          description: Filter chats by a Fanvue custom list UUID.
          example: 9c1f5f22-1c3e-4b2a-8a0f-2b6c5d4e3f21
          required: false
          schema:
            type: string
            description: Filter chats by a Fanvue custom list UUID.
            example: 9c1f5f22-1c3e-4b2a-8a0f-2b6c5d4e3f21
        - in: query
          name: search
          description: Search term matched against the fan's name or handle (max 100
            characters).
          example: jane
          required: false
          schema:
            type: string
            description: Search term matched against the fan's name or handle (max 100
              characters).
            example: jane
        - in: query
          name: sortBy
          description: "Sort order: `most_recent_messages`, `online_now` or
            `most_unanswered_chats`."
          example: most_recent_messages
          required: false
          schema:
            type: string
            description: "Sort order: `most_recent_messages`, `online_now` or
              `most_unanswered_chats`."
            example: most_recent_messages
        - in: query
          name: sortDirection
          description: "Sort direction: `asc` or `desc`."
          example: desc
          required: false
          schema:
            type: string
            description: "Sort direction: `asc` or `desc`."
            example: desc
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    data:
                      - createdAt: 2026-09-22T10:29:07.400Z
                        lastMessageAt: 2026-09-22T10:46:04.712Z
                        isRead: true
                        unreadMessagesCount: 0
                        isMuted: false
                        user:
                          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
                        lastMessage:
                          sentAt: 2026-09-22T10:46:04.712Z
                          text: See you tonight!
                          hasMedia: false
                          hasGif: false
                          type: SINGLE_RECIPIENT
                          mediaType: null
                          uuid: 3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33
                          senderUuid: 3bbe6394-2830-4646-a8ba-4a0a05426947
                          senderRole: CREATOR
                          sentByUserId: null
                          status: Read
                        online: true
                        lastSeenAt: 2026-09-22T11:23:37.916Z
                        isCreator: false
                        customLists: []
                    nextCursor: null
                    total: 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.
                properties:
                  data:
                    type: object
                    properties:
                      data:
                        type: array
                        example:
                          - createdAt: 2026-09-22T10:29:07.400Z
                            lastMessageAt: 2026-09-22T10:46:04.712Z
                            isRead: true
                            unreadMessagesCount: 0
                            isMuted: false
                            user:
                              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
                            lastMessage:
                              sentAt: 2026-09-22T10:46:04.712Z
                              text: See you tonight!
                              hasMedia: false
                              hasGif: false
                              type: SINGLE_RECIPIENT
                              mediaType: null
                              uuid: 3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33
                              senderUuid: 3bbe6394-2830-4646-a8ba-4a0a05426947
                              senderRole: CREATOR
                              sentByUserId: null
                              status: Read
                            online: true
                            lastSeenAt: 2026-09-22T11:23:37.916Z
                            isCreator: false
                            customLists: []
                        items:
                          type: object
                          properties:
                            createdAt:
                              type: string
                              example: 2026-09-22T10:29:07.400Z
                            lastMessageAt:
                              type: string
                              example: 2026-09-22T10:46:04.712Z
                            isRead:
                              type: boolean
                              example: true
                            unreadMessagesCount:
                              type: integer
                              example: 0
                            isMuted:
                              type: boolean
                              example: false
                            user:
                              type: object
                              properties:
                                uuid:
                                  type: string
                                  example: f47ac10b-58cc-4372-a567-0e02b2c3d479
                                handle:
                                  type: string
                                  example: sarah-jones
                                displayName:
                                  type: string
                                  example: Sarah Jones
                                nickname:
                                  type: string
                                  example: null
                                  nullable: true
                                isTopSpender:
                                  type: boolean
                                  example: false
                                avatarUrl:
                                  type: string
                                  example: null
                                  nullable: true
                                registeredAt:
                                  type: string
                                  example: 2026-09-21T12:05:33.176Z
                            lastMessage:
                              type: object
                              properties:
                                sentAt:
                                  type: string
                                  example: 2026-09-22T10:46:04.712Z
                                text:
                                  type: string
                                  example: See you tonight!
                                hasMedia:
                                  type: boolean
                                  example: false
                                hasGif:
                                  type: boolean
                                  example: false
                                type:
                                  type: string
                                  example: SINGLE_RECIPIENT
                                mediaType:
                                  type: string
                                  example: null
                                  nullable: true
                                uuid:
                                  type: string
                                  example: 3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33
                                senderUuid:
                                  type: string
                                  example: 3bbe6394-2830-4646-a8ba-4a0a05426947
                                senderRole:
                                  type: string
                                  example: CREATOR
                                sentByUserId:
                                  type: string
                                  example: null
                                  nullable: true
                                status:
                                  type: string
                                  example: Read
                            online:
                              type: boolean
                              example: true
                            lastSeenAt:
                              type: string
                              example: 2026-09-22T11:23:37.916Z
                            isCreator:
                              type: boolean
                              example: false
                            customLists:
                              type: array
                              example: []
                      nextCursor:
                        type: string
                        example: null
                        nullable: true
                      total:
                        type: string
                        example: null
                        nullable: true
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 10055811
                          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: 5000
                          limit_day:
                            type: string
                            example: null
                            nullable: true
                          remaining_minute:
                            type: integer
                            example: 4999
                          remaining_day:
                            type: string
                            example: null
                            nullable: true
                          notice:
                            type: string
                            example: We have decided to remove our daily rate limits. Please remove any
                              references to these in your integrations.
      tags:
        - Chats
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````