FAfanvue

Get spending reversal data for a creator

Changed on

Returns cursor-paginated reversal invoice data for the specified creator over a specified time period. Includes refund and chargeback transactions. A refund Fanvue issued to stop a chargeback is reported as chargeback, as the creator sees it in their earnings.

get/creators/{creatorUserUuid}/insights/spending

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/insights/spending
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator, read:insights

Path parameters

creatorUserUuidstring uuid required

Query parameters

startDatestring 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).

endDatestring 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.

sourceSpendingType[]

Comma-separated list of spending sources

Comma-separated list of spending sources. Default: all

cursorstring

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

sizenumber

Number of items to return per page (1-50, default: 20). When omitted on a cursor request, the size from the previous page (carried in the cursor) is reused.

fanUuidstring uuid

Restrict results to reversals belonging to a single fan on this creator

Headers

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

API version to use for the request

Response

Spending reversal data with cursor pagination

nextCursorstring nullable required

Cursor for next page, null if no more data

Changes