Skip to main content
POST
Enrich by Email
This endpoint consumes 1 enrichment credit per successful call. Requests that find no data return 409 no_match and do not consume credits. If the workspace balance is zero, the API returns 402 insufficient_credits.

Request

Use this endpoint to fetch enrichment data when you do not yet have a contact record - for example, scoring inbound leads before creating them or pre-populating a signup form. Unlike /v1/enrich/contact, this endpoint never writes to your database.

Headers

string
Optional UUID. Deduplicates retries within 24 hours; the credit is charged only on the first call.

Body Parameters

string
required
Email address to look up. Must be a syntactically valid RFC 5321 address.
array
Optional subset of sections to return: person, company, social. Defaults to all sections.
boolean
default:"false"
When true, additionally performs SMTP verification and returns deliverable status.

Response

object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.

Example Response

Errors