Skip to main content
GET
Retrieve identity profile
Required permissions:
  • identity:read

Autorisaties

Authorization
string
header
vereist

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

Scopes

identity:read

Padparameters

id
string
vereist

The unique identifier of the identity profile (idpf_xxx).

Voorbeeld:

"idpf_xxxxxxxxxxxxx"

Respons

A successful response

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

business_address
object | null
vereist

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

business_name
string | null
vereist

Business entity name. Present on business profiles.

business_structure
string | null
vereist

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

country
string | null
vereist

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>
vereist

When the identity profile was first created.

Voorbeeld:

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

date_of_birth
string | null
vereist

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

email
string | null
vereist

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

first_name
string | null
vereist

Individual's first name.

id
string
vereist

The tag of the identity profile (idpf_xxx).

Voorbeeld:

"idpf_xxxxxxxxxxxxx"

last_name
string | null
vereist

Individual's last name.

linked_companies
object[]
vereist

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>
vereist

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.

Beschikbare opties:
connected,
disabled,
action_required,
pending_verification,
verification_failed,
manual_review,
denied,
not_started,
blocked_by_parent
payouts_enabled
boolean
vereist

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
vereist

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

phone
string | null
vereist

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

profile_type
string
vereist

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

status
enum<string>
vereist

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.

Beschikbare opties:
not_started,
pending,
manual_review,
approved,
rejected,
action_required
updated_at
string<date-time>
vereist

When the identity profile was last synced from a verification.

Voorbeeld:

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

verifications
object[]
vereist

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