> ## 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 Earnings Summary (/api-reference/fanvue/insights/get-earnings-summary)

Get the creator's earnings pre-aggregated into all-time and this-month totals, a month-over-month comparison, source and type breakdowns, a chart series and averages by weekday and hour, so a dashboard does not have to sum transactions itself. Proxies Fanvue's `GET /v1/insights/earnings/summary`.

Money is in USD cents, paired as `gross` (pre-fee) and `net` (the creator's cut). Refunds and chargebacks are left out of both rather than subtracted, so these figures do not reconcile against List Earnings, which carries the reversals. `averageByDayOfWeek` (1 = Monday) and `averageByHourOfDay` are gross-only.

Referral, affiliate and giveaway earnings are creator rewards no fan paid for, and they land in `breakdownBySource.referrals` and `breakdownBySource.other`.

Fanvue caches this response for up to 10 minutes per creator and parameter set, so a figure can lag a payment that has already settled.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/insights/earnings/summary
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/summary:
    parameters:
      - in: path
        name: fanvueAccount
        description: The Fanvue Account ID
        example: fanvue_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: Get Earnings Summary
      operationId: getEarningsSummary
      description: >-
        Get the creator's earnings pre-aggregated into all-time and this-month
        totals, a month-over-month comparison, source and type breakdowns, a
        chart series and averages by weekday and hour, so a dashboard does not
        have to sum transactions itself. Proxies Fanvue's `GET
        /v1/insights/earnings/summary`.


        Money is in USD cents, paired as `gross` (pre-fee) and `net` (the
        creator's cut). Refunds and chargebacks are left out of both rather than
        subtracted, so these figures do not reconcile against List Earnings,
        which carries the reversals. `averageByDayOfWeek` (1 = Monday) and
        `averageByHourOfDay` are gross-only.


        Referral, affiliate and giveaway earnings are creator rewards no fan
        paid for, and they land in `breakdownBySource.referrals` and
        `breakdownBySource.other`.


        Fanvue caches this response for up to 10 minutes per creator and
        parameter set, so a figure can lag a payment that has already settled.
      parameters:
        - in: query
          name: startDate
          description: Only include earnings on or after this ISO 8601 datetime.
          example: 2026-03-01T00:00:00Z
          required: false
          schema:
            type: string
            description: Only include earnings on or after this ISO 8601 datetime.
            example: 2026-03-01T00:00:00Z
        - in: query
          name: endDate
          description: Only include earnings before this ISO 8601 datetime (non-inclusive).
          example: 2026-04-01T00:00:00Z
          required: false
          schema:
            type: string
            description: Only include earnings before this ISO 8601 datetime
              (non-inclusive).
            example: 2026-04-01T00:00:00Z
        - in: query
          name: granularity
          description: "Bucket size for the `overTime` series: `day` or `week`. Default =
            `day`"
          example: day
          required: false
          schema:
            type: string
            description: "Bucket size for the `overTime` series: `day` or `week`. Default =
              `day`"
            example: day
        - in: query
          name: timezone
          description: IANA timezone used for period grouping and month boundaries.
            Default = `UTC`
          example: Europe/London
          required: false
          schema:
            type: string
            description: IANA timezone used for period grouping and month boundaries.
              Default = `UTC`
            example: Europe/London
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    totals:
                      allTime:
                        gross: 399
                        net: 339
                      thisMonth:
                        gross: 399
                        net: 339
                        previousMonthGross: 0
                        previousMonthNet: 0
                        grossChangePercentage: null
                        netChangePercentage: null
                    breakdownBySource:
                      subs:
                        gross: 399
                        net: 339
                      messages:
                        gross: 0
                        net: 0
                      posts:
                        gross: 0
                        net: 0
                      tips:
                        gross: 0
                        net: 0
                      referrals:
                        gross: 0
                        net: 0
                      renewals:
                        gross: 0
                        net: 0
                      other:
                        gross: 0
                        net: 0
                    earningsByType:
                      renewals:
                        gross: 0
                        net: 0
                      messages:
                        gross: 0
                        net: 0
                      tips:
                        gross: 0
                        net: 0
                      subs:
                        gross: 399
                        net: 339
                    overTime:
                      - periodStart: 2026-09-22T00:00:00.000Z
                        gross: 399
                        net: 339
                    averageByDayOfWeek:
                      "1": 0
                      "2": 399
                      "3": 0
                      "4": 0
                      "5": 0
                      "6": 0
                      "7": 0
                    averageByHourOfDay:
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 399
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                    period:
                      startDate: 2026-09-01T00:00:00.000Z
                      endDate: 2026-10-01T00:00:00.000Z
                      granularity: day
                      timezone: UTC
                  _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:
                      totals:
                        type: object
                        properties:
                          allTime:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 399
                              net:
                                type: integer
                                example: 339
                          thisMonth:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 399
                              net:
                                type: integer
                                example: 339
                              previousMonthGross:
                                type: integer
                                example: 0
                              previousMonthNet:
                                type: integer
                                example: 0
                              grossChangePercentage:
                                type: string
                                example: null
                                nullable: true
                              netChangePercentage:
                                type: string
                                example: null
                                nullable: true
                      breakdownBySource:
                        type: object
                        properties:
                          subs:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 399
                              net:
                                type: integer
                                example: 339
                          messages:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          posts:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          tips:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          referrals:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          renewals:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          other:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                      earningsByType:
                        type: object
                        properties:
                          renewals:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          messages:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          tips:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 0
                              net:
                                type: integer
                                example: 0
                          subs:
                            type: object
                            properties:
                              gross:
                                type: integer
                                example: 399
                              net:
                                type: integer
                                example: 339
                      overTime:
                        type: array
                        example:
                          - periodStart: 2026-09-22T00:00:00.000Z
                            gross: 399
                            net: 339
                        items:
                          type: object
                          properties:
                            periodStart:
                              type: string
                              example: 2026-09-22T00:00:00.000Z
                            gross:
                              type: integer
                              example: 399
                            net:
                              type: integer
                              example: 339
                      averageByDayOfWeek:
                        type: object
                        properties:
                          "1":
                            type: integer
                            example: 0
                          "2":
                            type: integer
                            example: 399
                          "3":
                            type: integer
                            example: 0
                          "4":
                            type: integer
                            example: 0
                          "5":
                            type: integer
                            example: 0
                          "6":
                            type: integer
                            example: 0
                          "7":
                            type: integer
                            example: 0
                      averageByHourOfDay:
                        type: array
                        example:
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 399
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                          - 0
                        items:
                          type: integer
                      period:
                        type: object
                        properties:
                          startDate:
                            type: string
                            example: 2026-09-01T00:00:00.000Z
                          endDate:
                            type: string
                            example: 2026-10-01T00:00:00.000Z
                          granularity:
                            type: string
                            example: day
                          timezone:
                            type: string
                            example: UTC
                  _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
````