---
title: "Retrieve Person"
method: GET
path: "/people/{id}"
tags: ["People"]
---

# Retrieve Person

`GET /people/{id}`

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.

## Path parameters

- `id` string, required

## Query parameters

- `account_id` string

## Headers

- `Api-Version-Date` string

## Response `200`

person retrieved

- object — 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
  - `aov` number
  - `audience_ids` string[]
  - `custom_event_names` string[]
  - `device` object
    - `browser` string, nullable
    - `device` string, nullable
    - `os` string, nullable
  - `email` string, nullable — The email from the person's most recent event that carried one.
  - `emails` string[] — Every linked email, primary first.
  - `event_count` integer, required
  - `event_names` string[]
  - `first_purchase_at` string, date-time, nullable
  - `first_seen_at` string, date-time, required
  - `first_source` object, nullable — Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.
    - `ad` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `ad_group` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `campaign` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `domain` string, nullable
    - `occurred_at` string, date-time, nullable
    - `platform` string, nullable
    - `type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'utm', required
    - `utm_source` string, nullable
  - `id` string, required
  - `last_ip` string, nullable
  - `last_purchase_at` string, date-time, nullable
  - `last_seen_at` string, date-time, required
  - `last_source` object, nullable — Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.
    - `ad` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `ad_group` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `campaign` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `domain` string, nullable
    - `occurred_at` string, date-time, nullable
    - `platform` string, nullable
    - `type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'utm', required
    - `utm_source` string, nullable
  - `location` object
    - `city` string, nullable
    - `continent` string, nullable
    - `country` string, nullable
  - `ltv` number
  - `member` object, nullable — The user's member record at this account, when they are a member of it.
    - `id` string, required
    - `joined_at` string, date-time, nullable
    - `status` string, nullable
    - `usd_total_spend` number
  - `name` string, nullable — 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, nullable — The phone from the person's most recent event that carried one.
  - `phones` string[] — Every linked phone, primary first.
  - `purchase_count` integer, required
  - `purchases` object[]
    - `event_id` string, required
    - `occurred_at` string, date-time, required
    - `usd_value` number, required
  - `roles` string[]
  - `sources` object[] — Every distinct acquisition signal the person ever carried, ad entities hydrated.
    - `ad` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `ad_group` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `campaign` object, nullable
      - `id` string, required
      - `name` string, nullable
      - `thumbnail_url` string, nullable
    - `domain` string, nullable
    - `occurred_at` string, date-time, nullable
    - `platform` string, nullable
    - `type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'utm', required
    - `utm_source` string, nullable
  - `timezone` string, nullable
  - `usage` object — Exact usage breakdowns for the person's browser traffic (distinct events per value).
    - `browser` object[]
      - `events` integer, required
      - `value` string, required
    - `city` object[]
      - `events` integer, required
      - `value` string, required
    - `country` object[]
      - `events` integer, required
      - `value` string, required
    - `device` object[]
      - `events` integer, required
      - `value` string, required
    - `ip` object[]
      - `events` integer, required
      - `value` string, required
    - `os` object[]
      - `events` integer, required
      - `value` string, required
    - `referrer` object[]
      - `events` integer, required
      - `value` string, required
    - `timezone` object[]
      - `events` integer, required
      - `value` string, required
  - `user` object, nullable — The person's primary whop user, when one of their identities is a whop account.
    - `id` string, required
    - `name` string, nullable
    - `profile_pic_url` string, nullable
    - `username` string, required
  - `user_ids` string[] — Every linked whop account, the most used one first.

## Other responses

- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/c363cb2feb95/schema)