> ## 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 Smart Lists (/api-reference/fanvue/fans/list-smart-lists)

List Fanvue's smart lists with their member counts. Smart lists are audience segments Fanvue computes and keeps up to date itself, so there is nothing to create or maintain. Proxies Fanvue's `GET /v1/chats/lists/smart`.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/fans/lists
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/lists:
    parameters:
      - in: path
        name: fanvueAccount
        description: The Fanvue Account ID
        example: fanvue_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List Smart Lists
      operationId: listSmartLists
      description: List Fanvue's smart lists with their member counts. Smart lists are
        audience segments Fanvue computes and keeps up to date itself, so there
        is nothing to create or maintain. Proxies Fanvue's `GET
        /v1/chats/lists/smart`.
      parameters: []
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - uuid: subscribers
                      name: Subscribers
                      count: 1
                    - uuid: auto_renewing
                      name: Auto-renewing
                      count: 1
                    - uuid: non_renewing
                      name: Non-renewing
                      count: 0
                    - uuid: followers
                      name: Followers
                      count: 0
                    - uuid: free_trial_subscribers
                      name: Free trial subscribers
                      count: 0
                    - uuid: expired_subscribers
                      name: Expired subscribers
                      count: 0
                    - uuid: spent_more_than_50
                      name: Spent more than $50
                      count: 0
                    - uuid: muted
                      name: Muted
                      count: 0
                    - uuid: creators
                      name: Creators
                      count: 0
                  _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: array
                    example:
                      - uuid: subscribers
                        name: Subscribers
                        count: 1
                      - uuid: auto_renewing
                        name: Auto-renewing
                        count: 1
                      - uuid: non_renewing
                        name: Non-renewing
                        count: 0
                      - uuid: followers
                        name: Followers
                        count: 0
                      - uuid: free_trial_subscribers
                        name: Free trial subscribers
                        count: 0
                      - uuid: expired_subscribers
                        name: Expired subscribers
                        count: 0
                      - uuid: spent_more_than_50
                        name: Spent more than $50
                        count: 0
                      - uuid: muted
                        name: Muted
                        count: 0
                      - uuid: creators
                        name: Creators
                        count: 0
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          example: subscribers
                        name:
                          type: string
                          example: Subscribers
                        count:
                          type: integer
                          example: 1
                  _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
````