Resolve identity

Resolve a hashed email (HEM), plain email address, or LinkedIn profile URL to stored identity data. Provide exactly one of hem, email, or linkedin_url.

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. LinkedIn. linkedin_url accepts any pasted shape of a personal profile URL (linkedin.com/in/<slug>, with or without a scheme, www. or a locale subdomain, a trailing slash, ?trk= parameters, or deeper path segments). It is reduced to the vanity slug and resolved to the same record an email lookup returns. Company, school, and legacy /pub/ URLs are rejected with 400. hem_type does not apply.

Filtering and projection. Optional filter and select params apply the same grammar as /api/v3/events/{tier}, 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

LinkedIn personal profile URL, any pasted shape of linkedin.com/in/<slug>. Reduced to the vanity slug and resolved to the person's identity record. Not a /in/ profile URL returns 400.

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: no identifier or more than one of hem, email, linkedin_url; a malformed hem; a hem_type that does not match the hem; or a linkedin_url that is not a personal profile URL.

401

Missing or invalid authentication.

404

No record found for the given HEM.

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