HTTP Status Codes
The Enrow API uses standard HTTP status codes to indicate the result of each request.
Success Codes
| Code | Meaning | Description |
|---|
| 200 | OK | Request succeeded, results returned |
| 201 | Created | Resource created (e.g., bulk search initiated) |
| 202 | Accepted | Request accepted, processing asynchronously |
Client Error Codes
| Code | Meaning | Description |
|---|
| 400 | Bad Request | Invalid or missing parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | Resource not found (e.g., invalid search ID) |
| 422 | Unprocessable Entity | Insufficient balance |
| 429 | Too Many Requests | Rate limit exceeded |
Server Error Codes
| Code | Meaning | Description |
|---|
| 500 | Internal Server Error | Something went wrong on our end |
| 503 | Service Unavailable | Temporary maintenance or overload |
Search Qualifications
Enrow uses a qualification field across all endpoints. The result is always binary — there is no “maybe” or probability score. This is a deliberate design choice.
Why binary?
Most enrichment tools return a complex set of categories — catch-all, risky, unknown, unverifiable, etc. — that force you to build logic around probabilities. We took the opposite approach:
- Enrow verifies even catch-all emails deterministically, so there’s no need for a “catch-all” category
- We don’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
The result is either good or it’s not. Simple.
Email Finder
| Qualification | Meaning |
|---|
valid | Email found and verified |
invalid | Email not found |
ongoing | Search still in progress |
Email Verifier
| 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.
Phone Finder
| Qualification | Meaning |
|---|
found | Phone number successfully located |
not_found | Phone number could not be found |
ongoing | Search still in progress |
Bulk Search Status
For bulk operations, a status field indicates the batch progress:
| Status | Meaning |
|---|
ongoing | Batch is still processing |
completed | All searches in the batch are finished |
