Skip to main content
GET
Retrieve identity profile

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Path Parameters

id
string
required

The unique identifier of the identity profile (idpf_xxx).

Example:

"idpf_xxxxxxxxxxxxx"

Response

A successful response

A consolidated identity or business profile synced from verification provider data.

business_address
object | null
required

Registered business address reported by the identity provider. Present on business profiles.

business_name
string | null
required

Business entity name. Present on business profiles.

business_structure
string | null
required

Reported legal structure of a business profile (e.g. corp, llc). Provider-specific values; present on business profiles.

country
string | null
required

ISO 3166-1 alpha-2 country code reported by the identity provider, such as US or GB. For individuals this is the country of citizenship or residence; for businesses, the country of incorporation.

created_at
string<date-time>
required

When the identity profile was first created.

Example:

"2023-12-01T05:00:00.401Z"

date_of_birth
string | null
required

ISO date (YYYY-MM-DD) reported by the identity provider. Present on individual profiles.

email
string | null
required

Email address reported by the identity provider. Typically present on individual profiles.

first_name
string | null
required

Individual's first name.

id
string
required

The tag of the identity profile (idpf_xxx).

Example:

"idpf_xxxxxxxxxxxxx"

last_name
string | null
required

Individual's last name.

linked_companies
object[]
required

The companies this identity profile is currently linked to. Only populated for direct Whop user sessions; always empty when authenticated via API key, app, or OAuth scope (a single identity can be linked to companies the calling platform is not entitled to see).

payout_status
enum<string>
required

Progress of payout-account setup for this profile, independent of holds. connected means onboarding is complete; a connected status paired with payouts_enabled: false indicates an active account restriction rather than incomplete setup.

Available options:
connected,
disabled,
action_required,
pending_verification,
verification_failed,
manual_review,
denied,
not_started,
blocked_by_parent
payouts_enabled
boolean
required

Whether this profile can receive payouts right now. True only when payout onboarding is complete and no payout holds are active on the linked account. Treat this as the single source of truth for payout readiness.

personal_address
object | null
required

Residential address reported by the identity provider. Present on individual profiles.

phone
string | null
required

Phone number reported by the identity provider. Typically present on individual profiles.

profile_type
string
required

Whether this is an 'individual' or 'business' profile.

status
enum<string>
required

Derived verification status across all linked verifications. Returns action_required whenever the profile has an open request for information (whether a verification, payout, or audit RFI) — i.e. the merchant must submit something before it is in good standing.

Available options:
not_started,
pending,
manual_review,
approved,
rejected,
action_required
updated_at
string<date-time>
required

When the identity profile was last synced from a verification.

Example:

"2023-12-01T05:00:00.401Z"

verifications
object[]
required

All verification attempts attached to this identity profile, ordered most-recent first.