Question 1

Which enrichment requests are billable?

Accepted Answer

A request costs $0.02 when it returns ENRICHED, FREE_EMAIL_PROVIDER or DISPOSABLE, or HTTP 422 with error.reason: invalid_domain or invalid_email. Repeats are charged again. NOT_FOUND is free. Authentication failures, rate-limit rejections, malformed JSON, missing or conflicting fields, additional fields, and server or provider failures are free.

Question 2

What does NOT_FOUND mean, and will enrichment start later?

Accepted Answer

NOT_FOUND means no ready company profile is available in the database. The synchronous response is HTTP 400 with success: false and data: null, and it is free. The request does not start an enrichment job or require polling. It does not prove that the company does not exist.

Question 3

Should I send a domain or an email address?

Accepted Answer

Send exactly one JSON field: domain with a bare company domain, or email with a corporate email address. For email input, only the domain is used to find the company. The API does not identify the person or verify mailbox deliverability. Sending both fields or additional fields returns HTTP 422.

Company Enrichment

Frequently Asked Questions