Skip to main content
GET
Get a person
Returns the same acquisition attribution fields as List People, including the stored referrer, UTM fields, and campaign history when available.

Authorizations

X-API-Key
string
header
required

API key in format: mk_live_{40 hex chars}

Path Parameters

id
string
required

Person ID

Query Parameters

exclude_bad_emails
boolean
default:false

Blank any email field whose address is confirmed undeliverable (invalid, spamtrap, abuse, do_not_mail), matching what a verified CSV export does. The person is still returned, and emailVerification still reports the status, so you can see why a field came back empty. Addresses that are catch-all, unknown, or not yet verified are kept. Off by default — it empties fields existing integrations already read.

domain_group_id
string

Partner domain group ID. Matches exact member hostnames (www aliases normalized), including any member site the person has visited. Intersects domain, client_ref, and the key's scope; never grants extra access. Empty group returns zero matches; missing/foreign group returns 404; invalid ID returns 400. Keep this filter when following pagination cursors.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

Response

Person details

data
object