FAfanvue

List per-creator-per-day earnings across all agency creators

Returns a single paginated stream of per-creator-per-day earnings rows across every creator the authenticated agency manages, sorted by most recent day first. Each row is bucketed by paid_at (UTC) and tagged with creatorUuid so consumers can group results without an additional join.

Only PAID earning invoices that count towards creator insights are included. Each gross/net figure is the sum of the day's invoices in USD cents (currency is always "USD"), so totals reconcile with the USD figure shown on the dashboard. <Info>Requires: Agency admin access</Info>

get/agencies/earnings

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/agencies/earnings
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:agency, read:creator

Query parameters

pageinteger

Page number to retrieve (starts from 1)

sizeinteger

Number of items to return per page (1-50, default: 15)

startDatestring date-time required

Start of the date range (inclusive). UTC ISO 8601 datetime with offset.

endDatestring date-time required

End of the date range (exclusive). UTC ISO 8601 datetime with offset.

creatorUuidsstring[]

Comma-separated list of creator UUIDs (max 50)

Comma-separated list of creator UUIDs to restrict results to a subset of the agency's managed creators (max 50)

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Paginated list of per-creator-per-day earnings across the agency's creators

Changes

No recorded changes to this operation across all 8 revisions of this API.