> ## 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 Subscribers (/api-reference/fanvue/fans/list-subscribers) List the users holding a subscription to the creator, with each subscription's status, price in USD cents, current period end and auto-renew flag. For the subscribers about to lapse, use List Expiring Subscribers rather than paging this endpoint and filtering on `subscription.currentPeriodEnd` and `subscription.autoRenewalEnabled` yourself. Proxies Fanvue's `GET /v1/subscribers` and returns its body unchanged. The `nextCursor` carries the sort and date range the first page was cut under, so later pages need nothing but the cursor. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/fans/subscribers 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/subscribers: parameters: - in: path name: fanvueAccount description: The Fanvue Account ID example: fanvue_acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: List Subscribers operationId: listSubscribers description: >- List the users holding a subscription to the creator, with each subscription's status, price in USD cents, current period end and auto-renew flag. For the subscribers about to lapse, use List Expiring Subscribers rather than paging this endpoint and filtering on `subscription.currentPeriodEnd` and `subscription.autoRenewalEnabled` yourself. Proxies Fanvue's `GET /v1/subscribers` and returns its body unchanged. The `nextCursor` carries the sort and date range the first page was cut under, so later pages need nothing but the cursor. 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 subscribers to return (1 - 50). Default = 15 example: 15 required: false schema: type: integer description: Number of subscribers to return (1 - 50). Default = 15 example: 15 - in: query name: sortField description: "Field to sort by: `name` or `subscribedAt`. Default = `subscribedAt`" example: subscribedAt required: false schema: type: string description: "Field to sort by: `name` or `subscribedAt`. Default = `subscribedAt`" example: subscribedAt - in: query name: sortDirection description: "Sort direction: `asc` or `desc`. Default = `desc` for `subscribedAt`, `asc` for `name`" example: desc required: false schema: type: string description: "Sort direction: `asc` or `desc`. Default = `desc` for `subscribedAt`, `asc` for `name`" example: desc - in: query name: startDate description: Only include subscriptions started on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z required: false schema: type: string description: Only include subscriptions started on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z - in: query name: endDate description: Only include subscriptions started before this ISO 8601 datetime (non-inclusive). example: 2026-09-01T00:00:00Z required: false schema: type: string description: Only include subscriptions started before this ISO 8601 datetime (non-inclusive). example: 2026-09-01T00:00:00Z 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: null isTopSpender: false avatarUrl: null registeredAt: 2026-09-21T12:05:33.176Z subscription: status: active price: 399 amountPaid: 399 currentPeriodStart: 2026-09-22T10:29:07.224Z currentPeriodEnd: 2026-10-22T10:28:59.873Z autoRenewalEnabled: true firstSubscribedAt: 2026-09-22T10:29:07.474Z nextCursor: 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: - 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 subscription: status: active price: 399 amountPaid: 399 currentPeriodStart: 2026-09-22T10:29:07.224Z currentPeriodEnd: 2026-10-22T10:28:59.873Z autoRenewalEnabled: true firstSubscribedAt: 2026-09-22T10:29:07.474Z 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: 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 subscription: type: object properties: status: type: string example: active price: type: integer example: 399 amountPaid: type: integer example: 399 currentPeriodStart: type: string example: 2026-09-22T10:29:07.224Z currentPeriodEnd: type: string example: 2026-10-22T10:28:59.873Z autoRenewalEnabled: type: boolean example: true firstSubscribedAt: type: string example: 2026-09-22T10:29:07.474Z nextCursor: 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: - Fans components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````