c5ddcd5c7e72
List agency fan spend by country (cursor-paginated)
Returns the agency's paying fans grouped by billing country over the requested date range, ordered by fan count descending, then gross spend, then country code. Fans whose country is unknown are excluded, so shares should be computed against the returned rows rather than against the agency's total fan count.
Page with the opaque nextCursor from the previous response. The result set is bounded by the requested date range, so total is not computed and is always null. <Info>Requires: Agency admin access</Info>
Query parameters
Opaque pagination cursor from a previous response's nextCursor. Omit to fetch the first page.
Opaque pagination cursor from a previous response's nextCursor. Omit to fetch the first page.
Number of items to return (1-50, default: 15)
Number of items to return (1-50, default: 15)
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
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). Every uuid must belong to the agency: one that does not fails the whole request with 403 rather than being ignored.
Headers
API version to use for the request
Response
Cursor-paginated fan-country distribution