latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

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

Query parameters

pageinteger

Page number to retrieve (starts from 1)

Page number to retrieve (starts from 1)

sizeinteger

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

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.

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.

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