Get earnings data for a creator

Returns cursor-paginated invoice data for the specified creator over a specified time period.

Scopes required: read:creator, read:insights

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Query parameters

startDatestringOptionalformat: "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). Time component is ignored for daily aggregation.

endDatestringOptionalformat: "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. Time component is ignored for daily aggregation.

sourcelist of enumsOptional

Comma-separated list of earning sources. Default: all

cursorstringOptionalformat: "date-time"

Cursor for pagination - If given, pass nextCursor to get the next page.

sizedoubleOptional>=1<=50Defaults to 20

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

Response

Creator earnings data with cursor pagination

datalist of objects

nextCursorstring or null

Cursor for next page, null if no more data

1	{
2	"data": [
3	{
4	"date": "2024-01-15T00:00:00.000Z",
5	"gross": 5000,
6	"net": 4250,
7	"source": "subscription"
8	},
9	{
10	"date": "2024-01-14T00:00:00.000Z",
11	"gross": 2500,
12	"net": 2125,
13	"source": "tip"
14	}
15	],
16	"nextCursor": "2024-01-15T00:00:00.000Z"
17	}

Path parameters

Headers

Query parameters

Response

Errors

1	curl https://api.fanvue.com/creators/creatorUserUuid/insights/earnings \
2	-H "X-Fanvue-API-Version: 2025-06-26" \
3	-H "X-Fanvue-API-Key: <apiKey>"