Resolve up to 1000 hashed emails (HEMs), plain email addresses, or LinkedIn profile URLs in one call. Each key is resolved exactly as GET /api/v1/lookup would resolve it: SHA-256 (64 hex) or MD5 (32 hex) hems, algorithm inferred from the digest length or set per key with hem_type; plain emails are normalized and hashed for you. Keys may mix algorithms in one request.
Results are in input order, one entry per key. record is the identity record, or null when the key did not resolve, when filter rejected the record, or when that key could not be processed. A key that could not be processed (malformed hem, hem_type that does not match the hem, an algorithm with no lookup available, a linkedin_url that is not a profile URL) carries an error string on its entry; the request itself still succeeds and partial is true. Only an outage of the lookup backends fails the whole request.
Filtering and projection. Optional filter and select (in the body or as query params) apply per record with the same grammar as GET /api/v1/lookup. A record the filter rejects is returned as null and is not billed.
Billing. Metered on egress as contact_record: one per entry that returns a record. Misses, filtered-out records, and per-key errors bill nothing.
Dry run. Add "dry_run": true to the body, or ?dry_run=true, to size a list before you pay. The keys are resolved and filtered as in a live call. The response is the cost preview: records_to_charge is the exact number of records a live call returns, and field_coverage counts how many of them carry each person field, after select. No record and no identifier is returned, nothing is billed, and no payment method is needed.
Rate limit. Two requests per second per organization on this route, in addition to the per-client limit. At 1000 keys per request that is 2000 lookups per second; raise it with your Delivr contact if you need more.
Test keys. A test key gets deterministic mock records from the sandbox and is never billed. Responses carry the header X-Delivr-Mode: test.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Empty keys, more than 1000 keys, or a body that is not a JSON object with a keys array. Per-key problems do not produce a 400; they appear as error on that entry.
401Missing or invalid authentication.
429Rate limit exceeded.
502The lookup backends are unavailable.
504The lookup backends did not answer before the request deadline.
