qualification field that tells you the result of a search or verification. This page lists every code and qualification value so you can handle responses reliably. For the matching error messages and response formats, see Error handling.
What HTTP status codes does the API return?
The Enrow API uses standard HTTP status codes to indicate the result of each request. A2xx code means the request succeeded, a 4xx code points to a problem with the request, and a 5xx code means something went wrong on Enrow’s side.
Which codes mean success?
A2xx status code means the API accepted the request. Asynchronous operations (such as bulk searches) return 201 or 202 because the work continues in the background.
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded, results returned |
| 201 | Created | Resource created (e.g., bulk search initiated) |
| 202 | Accepted | Request accepted, processing asynchronously |
Which codes mean the request was rejected?
A4xx status code means the API rejected the request because of something it can fix on the client side — invalid parameters, a missing or invalid API key, insufficient credits, or too many requests.
| Code | Meaning | Description |
|---|---|---|
| 400 | Bad Request | Invalid or missing parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 402 | Payment Required | Insufficient credits |
| 429 | Too Many Requests | Rate limit exceeded |
401 means the API key is missing or invalid — see Authentication for how to pass it correctly. A 402 means the account is out of credits; review consumption in Credits & billing. A 429 means the request exceeded the allowed throughput — see Rate limits to understand the thresholds.
The API never returns 404. An unknown or expired search ID returns 400 for bulk endpoints and 500 for single endpoints.
Which codes mean a server error?
A5xx status code means the request was valid but something went wrong on Enrow’s end. These responses are safe to retry after a short delay.
| Code | Meaning | Description |
|---|---|---|
| 500 | Internal Server Error | Something went wrong on our end |
What are search qualifications?
A search qualification is the value in thequalification field that tells you the outcome of a search or verification. Enrow returns this field across all endpoints, and the result is always binary — there is no “maybe” or probability score. This is a deliberate design choice.
Why is the result binary?
The result is binary because a clear yes-or-no answer is easier to act on than a probability. Most enrichment tools return a complex set of categories — catch-all, risky, unknown, unverifiable, etc. — that force you to build logic around probabilities. Enrow took the opposite approach:- Enrow verifies even catch-all emails deterministically, so there’s no need for a “catch-all” category
- Enrow doesn’t believe in probabilistic systems with dozens of classifications — they add complexity without clarity
- A binary result means you can act on the data immediately without second-guessing
What qualifications does Email Finder return?
The Email Finder returns one of the following values in thequalification field:
| Qualification | Meaning |
|---|---|
valid | Email found and verified |
invalid | Email not found |
ongoing | Search still in progress |
What qualifications does Email Verifier return?
The Email Verifier returns one of the following values in thequalification field:
| Qualification | Meaning |
|---|---|
valid | Email is valid and deliverable |
invalid | Email is invalid or undeliverable |
ongoing | Verification still in progress |
invalid means different things depending on the endpoint: on the Email Finder, it means the email was not found. On the Email Verifier, it means the email exists but is not deliverable.What qualifications does Phone Finder return?
The Phone Finder returns one of the following values in thequalification field:
| Qualification | Meaning |
|---|---|
found | Phone number successfully located |
not_found | Phone number could not be found |
ongoing | Search still in progress |
How do I track a bulk search?
For bulk operations, astatus field indicates the batch progress. Poll the relevant GET endpoint — Email Finder bulk results, Email Verifier bulk verifications, or Phone Finder bulk results — until the status is completed.
| Status | Meaning |
|---|---|
ongoing | Batch is still processing |
completed | All searches in the batch are finished |
failed | The batch failed |
FAQ
Why am I getting a 401 instead of a 200?
Why am I getting a 401 instead of a 200?
A
401 Unauthorized means the API key is missing or invalid. Make sure every request includes a valid key in the x-api-key header. See Authentication for details.What does a 402 status code mean?
What does a 402 status code mean?
A
402 Payment Required means the account does not have enough credits to complete the request. Top up or review how credits are consumed per endpoint in Credits & billing.Why does an unknown search ID return 400 or 500 instead of 404?
Why does an unknown search ID return 400 or 500 instead of 404?
The Enrow API never returns
404. An unknown or expired search ID returns 400 for bulk endpoints and 500 for single endpoints. Double-check the id returned when the search was initiated.Does qualification: ongoing mean something failed?
Does qualification: ongoing mean something failed?
No.
ongoing means the search or verification is still in progress. Poll the GET endpoint again after a short delay, or use a webhook to be notified automatically when it finishes — see How webhooks work.Next steps
Error handling
See the full error messages and response formats for each status code.
Authentication
Pass your API key in the x-api-key header to avoid 401 errors.
Rate limits
Understand the thresholds that trigger a 429 response.
Credits & billing
See how credits are consumed and avoid 402 errors.