Get one contact by email

Search Documentation

Search across all developer documentation

contacts

Get one contact by email

GET /v1/contacts/{email}
Auth required api.contacts.view

Returns one contact by email address, including its custom attributes and explicit per-topic preferences. Returns 404 not_found when the address is not a contact in this org (the same response is returned when no contact list is synced, so the endpoint never leaks which case applies). Match is case-insensitive. Percent-encode @ as %40 (e.g. user%40example.com).

Path parameters

email string<email> required

Recipient address. Percent-encode @ as %40. Matched case-insensitively.

Responses

200 The contact record application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json