> ## 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 Followers (/api-reference/fanvue/fans/list-followers)

List the users following the creator, most recently followed first. A fan who follows and subscribes appears here as well as in the subscribers list, so de-duplicate on `uuid` if you merge the two. Proxies Fanvue's `GET /v1/followers`.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/fans/followers
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}/fans/followers:
    parameters:
      - in: path
        name: fanvueAccount
        description: The Fanvue Account ID
        example: fanvue_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List Followers
      operationId: listFollowers
      description: List the users following the creator, most recently followed first.
        A fan who follows and subscribes appears here as well as in the
        subscribers list, so de-duplicate on `uuid` if you merge the two.
        Proxies Fanvue's `GET /v1/followers`.
      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 followers to return (1 - 50). Default = 15
          example: 15
          required: false
          schema:
            type: integer
            description: Number of followers to return (1 - 50). Default = 15
            example: 15
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    data:
                      - uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479
                        handle: sarah-jones
                        displayName: Sarah Jones
                        nickname: SarahK
                        isTopSpender: true
                        avatarUrl: https://media.fanvue.com/avatars/example-avatar.jpg
                        registeredAt: 2024-01-10T12:00:00.000Z
                    nextCursor: eyJ2IjoyfQ
                  _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:
                          - uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479
                            handle: sarah-jones
                            displayName: Sarah Jones
                            nickname: SarahK
                            isTopSpender: true
                            avatarUrl: https://media.fanvue.com/avatars/example-avatar.jpg
                            registeredAt: 2024-01-10T12:00:00.000Z
                        items:
                          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: SarahK
                            isTopSpender:
                              type: boolean
                              example: true
                            avatarUrl:
                              type: string
                              example: https://media.fanvue.com/avatars/example-avatar.jpg
                            registeredAt:
                              type: string
                              example: 2024-01-10T12:00:00.000Z
                      nextCursor:
                        type: string
                        example: eyJ2IjoyfQ
                  _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:
        - Fans
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````