FAfanvue

Get fan insights in bulk

Changed on

Returns detailed insights for multiple fans in a single request.

This endpoint is optimized for chat list screens that need to hydrate fan insights without per-fan round trips.

Every field carries the same meaning as on GET /insights/fans/{userUuid}, including which money fields are net of reversals and which are gross, and the same absence of caching.

<Note>Maximum 20 fan UUIDs per request.</Note>

get/insights/fans

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/insights/fans
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:insights, read:fan

Query parameters

fanUuidsstring required

Comma-separated fan UUIDs to fetch insights for (max 20)

Headers

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

API version to use for the request

Response

Insight data about the user's fans

resultsobject required

Map fan UUID -> insights payload (null when unavailable)

Changes

  • dce5621fe589Revision changes
    • info

      added the required property /// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property //// to the response with the status