Lookup by email - Context.dev

Use type: "by_email" to retrieve the company associated with a work email. This resolves the email’s domain; it does not identify the person.

Request

Send this body to POST /brand/retrieve. See the Quickstart for authentication and SDK setup.

{
  "type": "by_email",
  "email": "[email protected]"
}

For a signup form, debounce until the email is valid, fill suggestions from the returned profile, and preserve the user’s corrections. Use People if you need a person profile.

Handle personal email addresses

Response	Action
`422 FREE_EMAIL_DETECTED`	Skip company enrichment or ask for a website.
`422 DISPOSABLE_EMAIL_DETECTED`	Skip the address.
`422 COLD_DOMAIN_TIMEOUT_TOO_LOW`	Allow more time or prefetch.
`400 NOT_FOUND`	Keep an unresolved company state.

An uncached domain needs at least 10,000 ms with behavior: "fail"; use a longer deadline for cold lookups. See lookup by domain.