Get fan insights in bulk

curl -G https://api.fanvue.com/insights/fans \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>" \
     -d fanUuids=fanUuids

{
  "results": {
    "11111111-1111-1111-1111-111111111111": {
      "status": "subscriber",
      "spending": {
        "lastPurchaseAt": "2024-01-14T00:00:00.000Z",
        "total": {
          "gross": 27700
        },
        "maxSinglePayment": {
          "gross": 5000
        },
        "sources": {
          "message": {
            "gross": 15000
          },
          "post": {
            "gross": 8500
          },
          "referral": {
            "gross": 4200
          }
        }
      },
      "subscription": {
        "createdAt": "2024-01-01T12:00:00.000Z",
        "renewsAt": "2024-02-01T00:00:00.000Z",
        "autoRenewalEnabled": true
      }
    }
  },
  "errors": [
    {
      "fanUuid": "22222222-2222-2222-2222-222222222222",
      "code": "NOT_FOUND",
      "message": "The specified fan does not exist or is not connected to this creator."
    }
  ]
}

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.

Scopes required: read:insights, read:fan

Maximum 20 fan UUIDs per request.

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. <Info>Scopes required: `read:insights`, `read:fan`</Info> <Note>Maximum 20 fan UUIDs per request.</Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

fanUuidsstringRequired

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

Response

Insight data about the user's fans

resultsmap from strings to objects

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

errorslist of objects

Per-fan errors for unresolved entries

Authentication

Headers

Query parameters

Response

Errors