---
title: "Get aggregated earnings summary for a creator"
method: GET
path: "/creators/{creatorUserUuid}/insights/earnings/summary"
---

# Get aggregated earnings summary for a creator

`GET /creators/{creatorUserUuid}/insights/earnings/summary`

Returns pre-aggregated earnings metrics for the specified creator, including all-time totals, month-over-month comparisons, source/type breakdowns, chart series, and averages.

## Path parameters

- `creatorUserUuid` string, uuid, required

## Query parameters

- `startDate` string, date-time — Start date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-20T00:00:00+01:00 or 2024-10-20T00:00:00Z).
- `endDate` string, date-time — End date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-25T00:00:00+01:00 or 2024-10-25T00:00:00Z). Non-inclusive - data before this date is included.
- `granularity` 'day' | 'week' — Aggregation granularity for the over-time chart
- `timezone` string — IANA timezone used for period grouping and month boundaries (e.g., Europe/London, America/New_York)

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

Creator aggregated earnings summary

- object
  - `totals` object, required
    - `allTime` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `thisMonth` object, required
      - `gross` number, required
      - `net` number, required
      - `previousMonthGross` number, required
      - `previousMonthNet` number, required
      - `grossChangePercentage` number, nullable, required
      - `netChangePercentage` number, nullable, required
  - `breakdownBySource` object, required
    - `subs` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `messages` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `posts` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `tips` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `referrals` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `renewals` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `other` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
  - `earningsByType` object, required
    - `renewals` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `messages` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `tips` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
    - `subs` object, required
      - `gross` number, required — Amount the fan paid, in USD cents
      - `net` number, required — Creator's cut after Fanvue fees, in USD cents
  - `overTime` object[], required
    - `periodStart` string, date-time, required — Start of the aggregation bucket in ISO 8601 with timezone offset
    - `gross` number, required — Amount fans paid in this bucket, in USD cents
    - `net` number, required — Creator's cut after Fanvue fees in this bucket, in USD cents
  - `averageByDayOfWeek` object, required — Average gross earnings by ISO day-of-week (1=Monday, 7=Sunday)
    - `1` number, required
    - `2` number, required
    - `3` number, required
    - `4` number, required
    - `5` number, required
    - `6` number, required
    - `7` number, required
  - `averageByHourOfDay` object, required — Average gross earnings by hour-of-day in the selected timezone (0-23)
  - `period` object, required
    - `startDate` string, nullable, required
    - `endDate` string, nullable, required
    - `granularity` 'day' | 'week', required
    - `timezone` string, required

## Other responses

- `400` — Bad Request - API version not supported OR validation failed (dates, sources, cursor, pagination) OR invalid UUID
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Not Found Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)