Skip to main content
GET
/
agencies
/
earnings
List per-creator-per-day earnings across all agency creators
curl --request GET \
  --url https://api.example.com/agencies/earnings \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
      "date": "2024-01-15",
      "gross": 15000,
      "net": 12750,
      "currency": "USD"
    },
    {
      "creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r9",
      "date": "2024-01-14",
      "gross": 8500,
      "net": 7225,
      "currency": "USD"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}
Required scopes
  • read:agency — Read agency information, including the agency’s team members.
  • read:creator — Access creator profiles, content, and creator-specific information.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Query Parameters

​
page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
​
size
number
default:15

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

Required range: 1 <= x <= 50
​
startDate
string<date-time>
required

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

​
endDate
string<date-time>
required

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

​
creatorUuids
string<uuid>[]

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

Maximum array length: 50

Response

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

​
data
object[]
required

Array of per-creator-per-day earnings rows across the agency's creators

​
pagination
object
required

Pagination information