> ## 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 Earnings (/api-reference/fanvue/insights/list-earnings) List the creator's transactions over a date range, each with the fan who paid, so revenue can be reconciled row by row. Proxies Fanvue's `GET /v1/insights/earnings`. Money is in USD cents. `gross` is pre-fee, `net` is the creator's cut after Fanvue's fees, and `currency` only records what the fan originally paid in: both amounts are already converted. Refunds and chargebacks come back as their own rows with negative amounts and a `reversedTransactionOrderId` pointing at the transaction they reverse, so the original row is never rewritten. `user` is null on rows no fan paid for, which is the normal case for `referral`, `affiliate` and `giveaway`. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/insights/earnings 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}/insights/earnings: parameters: - in: path name: fanvueAccount description: The Fanvue Account ID example: fanvue_acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: List Earnings operationId: listEarnings description: >- List the creator's transactions over a date range, each with the fan who paid, so revenue can be reconciled row by row. Proxies Fanvue's `GET /v1/insights/earnings`. Money is in USD cents. `gross` is pre-fee, `net` is the creator's cut after Fanvue's fees, and `currency` only records what the fan originally paid in: both amounts are already converted. Refunds and chargebacks come back as their own rows with negative amounts and a `reversedTransactionOrderId` pointing at the transaction they reverse, so the original row is never rewritten. `user` is null on rows no fan paid for, which is the normal case for `referral`, `affiliate` and `giveaway`. 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 transactions to return (1 - 50). Default = 20 example: 20 required: false schema: type: integer description: Number of transactions to return (1 - 50). Default = 20 example: 20 - in: query name: startDate description: Only include transactions on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z required: false schema: type: string description: Only include transactions on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z - in: query name: endDate description: Only include transactions before this ISO 8601 datetime (non-inclusive). example: 2026-09-01T00:00:00Z required: false schema: type: string description: Only include transactions before this ISO 8601 datetime (non-inclusive). example: 2026-09-01T00:00:00Z - in: query name: source description: "Restrict to these earning sources: `all`, `affiliate`, `appStore`, `checkoutLink`, `fanExperience`, `mediaLink`, `message`, `post`, `referral`, `renewal`, `subscription`, `tip`, `giveaway`, `refund`, `chargeback`. Default = all. Note that every recurring charge after the first bills as `renewal`, whether it started as a subscription, a checkout link or a fan experience; an app store charge is the one exception and stays `appStore`." example: - tip - message required: false schema: type: array description: "Restrict to these earning sources: `all`, `affiliate`, `appStore`, `checkoutLink`, `fanExperience`, `mediaLink`, `message`, `post`, `referral`, `renewal`, `subscription`, `tip`, `giveaway`, `refund`, `chargeback`. Default = all. Note that every recurring charge after the first bills as `renewal`, whether it started as a subscription, a checkout link or a fan experience; an app store charge is the one exception and stays `appStore`." example: - tip - message items: type: string - in: query name: transactionOrderIds description: Return only these transaction order ids (max 100), to re-check known transactions for a status change. Combines with the other filters and still paginates. example: - FV-ORDER-123 required: false schema: type: array description: Return only these transaction order ids (max 100), to re-check known transactions for a status change. Combines with the other filters and still paginates. example: - FV-ORDER-123 items: type: string responses: "200": description: Success content: application/json: schema: type: object example: data: data: - date: 2026-09-22T10:29:07.224Z gross: 399 net: 339 currency: null source: subscription transactionOrderId: FVE-20260922-41280 transactionOrderStatus: pendingBalance user: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones displayName: Sarah Jones nickname: null isTopSpender: false - date: 2026-09-21T14:02:55.118Z gross: -399 net: -339 currency: null source: refund transactionOrderId: FVE-20260921-40118 transactionOrderStatus: availableForPayout reversedTransactionOrderId: FVE-20260921-40117 user: uuid: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 handle: mike-smith displayName: Mike Smith nickname: null isTopSpender: false 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: - date: 2026-09-22T10:29:07.224Z gross: 399 net: 339 currency: null source: subscription transactionOrderId: FVE-20260922-41280 transactionOrderStatus: pendingBalance user: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones displayName: Sarah Jones nickname: null isTopSpender: false - date: 2026-09-21T14:02:55.118Z gross: -399 net: -339 currency: null source: refund transactionOrderId: FVE-20260921-40118 transactionOrderStatus: availableForPayout reversedTransactionOrderId: FVE-20260921-40117 user: uuid: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 handle: mike-smith displayName: Mike Smith nickname: null isTopSpender: false items: type: object properties: date: type: string example: 2026-09-22T10:29:07.224Z gross: type: integer example: 399 net: type: integer example: 339 currency: type: string example: null nullable: true source: type: string example: subscription transactionOrderId: type: string example: FVE-20260922-41280 transactionOrderStatus: type: string example: pendingBalance 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 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: - Insights components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````