> ## 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. # Get Fan Insights (/api-reference/fanvue/fans/get-fan-insights) Get one fan's relationship with the creator: their status, what they have spent and how, and their subscription renewal. Proxies Fanvue's `GET /v1/insights/fans/{userUuid}`. Every money figure comes gross and net, net meaning refunded and charged-back purchases removed. `spending.total.total` has always been net of reversals, so the gross per-source figures can add up to more than it and the gap is exactly the reversals. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/fans/{userUuid}/insights 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/{userUuid}/insights: parameters: - in: path name: fanvueAccount description: The Fanvue Account ID example: fanvue_acct_XXXXXXXXXXXXXXX required: true schema: type: string - in: path name: userUuid description: The fan's Fanvue user UUID. example: f47ac10b-58cc-4372-a567-0e02b2c3d479 required: true schema: type: string get: summary: Get Fan Insights operationId: getFanInsights description: >- Get one fan's relationship with the creator: their status, what they have spent and how, and their subscription renewal. Proxies Fanvue's `GET /v1/insights/fans/{userUuid}`. Every money figure comes gross and net, net meaning refunded and charged-back purchases removed. `spending.total.total` has always been net of reversals, so the gross per-source figures can add up to more than it and the gap is exactly the reversals. parameters: [] responses: "200": description: Success content: application/json: schema: type: object example: data: status: subscriber spending: lastPurchaseAt: 2026-09-22T10:29:07.224Z lastValidPurchaseAt: 2026-09-22T10:29:07.224Z total: gross: 536 total: 536 netTotal: 536 maxSinglePayment: gross: 536 total: 536 sources: subscription: gross: 536 total: 536 netTotal: 536 count: 1 netCount: 1 average: 536 netAverage: 536 subscription: createdAt: 2026-09-22T10:29:07.224Z renewsAt: 2026-10-22T10:28:59.873Z autoRenewalEnabled: true _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: status: type: string example: subscriber spending: type: object properties: lastPurchaseAt: type: string example: 2026-09-22T10:29:07.224Z lastValidPurchaseAt: type: string example: 2026-09-22T10:29:07.224Z total: type: object properties: gross: type: integer example: 536 total: type: integer example: 536 netTotal: type: integer example: 536 maxSinglePayment: type: object properties: gross: type: integer example: 536 total: type: integer example: 536 sources: type: object properties: subscription: type: object properties: gross: type: integer example: 536 total: type: integer example: 536 netTotal: type: integer example: 536 count: type: integer example: 1 netCount: type: integer example: 1 average: type: integer example: 536 netAverage: type: integer example: 536 subscription: type: object properties: createdAt: type: string example: 2026-09-22T10:29:07.224Z renewsAt: type: string example: 2026-10-22T10:28:59.873Z autoRenewalEnabled: type: boolean example: 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 ````