Sign in
latestOpenAPI 3.1.02026-08-163864115.7 MB

c363cb2feb95

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/{id}

Path parameters

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

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.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "aov": 74.99,
  "audience_ids": [
    "Dana Whitfield"
  ],
  "custom_event_names": [
    "Dana Whitfield"
  ],
  "device": {
    "browser": "Dana Whitfield",
    "device": "Dana Whitfield",
    "os": "Dana Whitfield"
  },
  "email": "marcus@shinetime.example",
  "emails": [
    "Dana Whitfield"
  ],
  "event_count": 42,
  "event_names": [
    "Dana Whitfield"
  ],
  "first_purchase_at": "2026-01-01T12:00:00.000Z",
  "first_seen_at": "2026-01-01T12:00:00.000Z",
  "first_source": {
    "ad": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "ad_group": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "campaign": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "domain": "Dana Whitfield",
    "occurred_at": "2026-01-01T12:00:00.000Z",
    "platform": "Dana Whitfield",
    "type": "ad_click",
    "utm_source": "Dana Whitfield"
  },
  "id": "prsn_123",
  "last_ip": "Dana Whitfield",
  "last_purchase_at": "2026-01-01T12:00:00.000Z",
  "last_seen_at": "2026-01-01T12:00:00.000Z",
  "last_source": {
    "ad": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "ad_group": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "campaign": {
      "id": "adcamp_1",
      "name": "Dana Whitfield",
      "thumbnail_url": "Dana Whitfield"
    },
    "domain": "Dana Whitfield",
    "occurred_at": "2026-01-01T12:00:00.000Z",
    "platform": "Dana Whitfield",
    "type": "ad_click",
    "utm_source": "Dana Whitfield"
  },
  "location": {
    "city": "Dana Whitfield",
    "continent": "Dana Whitfield",
    "country": "Dana Whitfield"
  },
  "ltv": 149.98,
  "member": {
    "id": "mem_dana1",
    "joined_at": "2026-01-01T12:00:00.000Z",
    "status": "Dana Whitfield",
    "usd_total_spend": 149.98
  },
  "name": "Dana Whitfield",
  "names": [
    "Dana Whitfield"
  ],
  "phone": "+xxxxxxxxxxx",
  "phones": [
    "Dana Whitfield"
  ],
  "purchase_count": 2,
  "purchases": [
    {
      "event_id": "evt_2",
      "occurred_at": "2026-01-01T12:00:00.000Z",
      "usd_value": 74.99
    }
  ],
  "roles": [
    "Dana Whitfield"
  ],
  "sources": [
    {
      "ad": {
        "id": "adcamp_1",
        "name": "Dana Whitfield",
        "thumbnail_url": "Dana Whitfield"
      },
      "ad_group": {
        "id": "adcamp_1",
        "name": "Dana Whitfield",
        "thumbnail_url": "Dana Whitfield"
      },
      "campaign": {
        "id": "adcamp_1",
        "name": "Dana Whitfield",
        "thumbnail_url": "Dana Whitfield"
      },
      "domain": "Dana Whitfield",
      "occurred_at": "2026-01-01T12:00:00.000Z",
      "platform": "Dana Whitfield",
      "type": "ad_click",
      "utm_source": "Dana Whitfield"
    }
  ],
  "timezone": "Dana Whitfield",
  "usage": {
    "browser": [
      {
        "events": 10,
        "value": "Chrome"
      }
    ],
    "city": [
      {
        "events": 9,
        "value": "Austin"
      }
    ],
    "country": [
      {
        "events": 12,
        "value": "US"
      }
    ],
    "device": [
      {
        "events": 5,
        "value": "iPhone"
      }
    ],
    "ip": [
      {
        "events": 3,
        "value": "1.1.1.1"
      }
    ],
    "os": [
      {
        "events": 7,
        "value": "Mac OS X"
      }
    ],
    "referrer": [
      {
        "events": 4,
        "value": "google.com"
      }
    ],
    "timezone": [
      {
        "events": 12,
        "value": "America/Chicago"
      }
    ]
  },
  "user": {
    "id": "user_dana1",
    "name": "Dana Whitfield",
    "profile_pic_url": "Dana Whitfield",
    "username": "danawhitfield"
  },
  "user_ids": [
    "Dana Whitfield"
  ]
}