Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-139714.9 KB
Lookup

Look up an email or domain (authenticated)

post/v1/lookup

Request body

inputstring required

Email or domain. Examples: 'jane@stripe.com', 'stripe.com'.

refreshboolean

Force a fresh enrichment-provider call instead of using the cached row. Debounced to 60s per domain.

include_rawboolean

Include the raw provider JSON in meta.raw. Off by default to keep responses small.

Example request

{
  "input": "jane@stripe.com"
}

Response

Lookup result.

domainstring required

Registrable (eTLD+1) form, lowercased, punycoded.

domain_unicodestring

IDN-decoded display form.

category'free' | 'disposable' | 'educational' | 'government' | 'isp' | 'company' | 'unknown' required
subcategorystring nullable
is_emailboolean required
input_normalizedstring
cachedboolean required
fetched_atstring date-time required
last_refreshed_atstring date-time nullable