Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-08-10"

Path Parameters

person_id
string
required

The person ID, user ID, email address, or phone number to look up.

Query Parameters

account_id
string

Account ID, prefixed biz_. Optional for account API keys; required for credentials that can access multiple accounts.

Response

person retrieved

The full profile a retrieve returns: the summary plus every linked identity, purchase rows, all acquisition sources, and exact usage breakdowns.

account_id
string
required
event_count
integer
required
first_seen_at
string<date-time>
required
id
string
required
last_seen_at
string<date-time>
required
purchase_count
integer
required
aov
number
audience_ids
string[]
custom_event_names
string[]
device
object
email
string | null

The email from the person's most recent event that carried one.

emails
string[]

Every linked email, primary first.

event_names
string[]
first_purchase_at
string<date-time> | null
first_source
object | null

Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.

last_ip
string | null
last_purchase_at
string<date-time> | null
last_source
object | null

Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.

location
object
ltv
number
member
object | null

The user's member record at this account, when they are a member of it.

name
string | null

The name from the person's most recent event that carried one.

names
string[]

Every name the person's linked identities carried, primary first.

phone
string | null

The phone from the person's most recent event that carried one.

phones
string[]

Every linked phone, primary first.

purchases
object[]
roles
string[]
sources
object[]

Every distinct acquisition signal the person ever carried, ad entities hydrated.

timezone
string | null
usage
object

Exact usage breakdowns for the person's browser traffic (distinct events per value).

user
object | null

The person's primary whop user, when one of their identities is a whop account.

user_ids
string[]

Every linked whop account, the most used one first.