Skip to main content
GET
/
people
/
{person_id}
Retrieve Person
curl --request GET \
  --url https://{defaultHost}/people/{person_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "<string>",
    "person_id": "<string>",
    "first_seen_at": 123,
    "last_seen_at": 123,
    "purchase_count": 123,
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "has_failed_payment": true,
    "ltv": 123,
    "aov": 123,
    "campaigns": [
      {
        "id": "<string>",
        "name": "<string>",
        "thumbnail_url": "<string>"
      }
    ],
    "ad_sets": [
      {
        "id": "<string>",
        "name": "<string>",
        "thumbnail_url": "<string>"
      }
    ],
    "ads": [
      {
        "id": "<string>",
        "name": "<string>",
        "thumbnail_url": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

An account API key, account scoped JWT, app API key, or user OAuth token.

Path Parameters

​
person_id
string
required

The ID of the person.

Query Parameters

​
account_id
string

The ID of the account, which will look like biz_*************. Optional for account API keys; required for credentials that can access multiple accounts.

​
from
integer

Start of the time range as a Unix timestamp.

​
to
integer

End of the time range as a Unix timestamp. Defaults to now.

Response

person retrieved

​
data
object
required