Skip to main content
GET
Find a person

Authorizations

Authorization
string
header
required

A secret key (sk_live_… / sk_test_…) from Settings → API keys. Server-side only.

Query Parameters

email
string<email>

The respondent's email (case-insensitive).

external_id
string

Your id for the respondent. Pass both to require both to match.

Response

The person.

Example values are illustrative.

id
string<uuid>
required
email
string | null
required
external_id
string | null
required
name
string | null
required
domain
string | null
required
first_touch_channel
string | null
required

The channel click-based analytics would credit (UTMs, referrer), when known.

created_at
string<date-time>
required
responses
object[]
required

Their responses, newest first (up to 100).

billing
object | null
required

Their matched billing customers, summed; null when none is matched.