Resolve identity

Resolve a hashed email (HEM) or plain email address to stored identity data.
Provide either hem or email (not both).

Hash type. A hem is matched by algorithm: SHA-256 (64 hex characters)
or MD5 (32 hex characters). The algorithm is inferred from the digest length;
pass hem_type to set it explicitly (it is then validated against the hem).
When email is provided instead, it is normalized and hashed for you.

Filtering and projection. Optional filter and select params apply the
same grammar as /api/v1/events, evaluated against the single resolved record:

  • select projects a subset of fields (comma-separated). Absent fields are omitted.
  • filter (<field>:<op>:<value>, , = AND, | = OR within a group; ops
    eq, ne, like, not_null) decides whether the record is returned. If the
    record does not match, the endpoint responds 404 (no record). Example —
    business-email records only:
    filter=current_business_email:ne:""|business_emails:ne:""|is_email_business:eq:"true".
    Quote literal values (is_email_business:eq:"true").

Billing. Metered on egress as contact_record (the same meter as a
contact query or audience download, not the events resolution_* tiers):
a 200 that returns a record bills one contact record; a 404 (not found
or filtered out) bills nothing. select projects fields but does not change
the meter.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Hashed email (HEM) to look up. SHA-256 (64 hex characters) or MD5
(32 hex characters); the algorithm is inferred from the length, or set
it explicitly with hem_type.

string
enum

Hash algorithm of hem: sha256 or md5. Optional. When omitted, the
algorithm is inferred from the digest length (64 hex = sha256,
32 hex = md5). When provided, it is validated against the hem; a
mismatch (or an unsupported value) returns 400.

Allowed:
string

Plain-text email (normalized and hashed automatically).

string

Filter expression applied to the resolved record. <field>:<op>:<value>;
, = AND, | = OR within a clause group; ops eq, ne, like,
not_null. A non-matching record yields 404. Quote literal values.

string

Comma-separated field list to project. Absent fields are omitted.

Responses

400

Invalid input: neither hem nor email provided, a malformed hem, or a
hem_type that does not match the hem.

401

Missing or invalid authentication.

404

No record found for the given HEM.

429

Rate limit exceeded.

500

Internal server error.

501

Lookup is not available for the requested hem type.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json