Skip to main content
POST
Get fan profiles in bulk
Required scope
  • read:fan — Access fan-related data and information within the platform.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Body

application/json
userUuids
string<uuid>[]
required

Array of fan UUIDs to fetch profiles for (1-100)

Required array length: 1 - 100 elements

Response

Per-key profile or error for each requested fan. Always 200 when the request itself is valid, even if every key fails.

Map of input fan UUID to the fan's profile or a per-key error (forbidden, not_found, or internal). Profiles are returned for the same fans /insights/fans/batch returns insights for — fans connected to the creator by subscription or follow.

{key}
object