Sign in

v9

OpenAPI 3.1.02026-08-043703845.2 MB
People

Retrieve Person

Retrieves one person for an account. The identifier can be a person ID (prefixed prsn_), a user ID (prefixed user_), an email address, or a phone number — merged people resolve to the surviving profile.

get/people/{person_id}

Path parameters

person_idstring required

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

Query parameters

account_idstring

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

Headers

Api-Version-Datestring
Example:2026-08-03

Pins the request to a dated API version.

Response

person retrieved

account_idstring required
aovnumber
audience_idsstring[]
custom_event_namesstring[]
emailstring nullable

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

emailsstring[]

Every linked email, primary first.

event_countinteger required
event_namesstring[]
first_purchase_atstring date-time nullable
first_seen_atstring date-time required
idstring required
last_ipstring nullable
last_purchase_atstring date-time nullable
last_seen_atstring date-time required
ltvnumber
namestring nullable

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

namesstring[]

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

phonestring nullable

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

phonesstring[]

Every linked phone, primary first.

purchase_countinteger required
rolesstring[]
timezonestring nullable
user_idsstring[]

Every linked whop account, the most used one first.