Skip to main content
GET
/
email
/
verify
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}
GET
https://api.enrow.io/email/verify/bulk?id={id}
Retrieve all results from a bulk email verification using the batch ID. Authenticate every request with your API key in the x-api-key header. To start a batch first, use the Verify Bulk Emails endpoint.
Using a webhook allows you to skip calling this GET endpoint. See How Webhooks Work.

Query Parameters

id
string
required
The id returned from the POST request

Response

200 — Verification completed

general
object
Batch metadata
stats
object
Batch statistics
results
array
Array of verification results

200 — Verification still in progress

While the batch is still running, the endpoint returns HTTP 200 with the batch state instead of the full results.
general
object
Batch metadata
stats
object
Batch progress

Error Responses

CodeMessage
400Could not retrieve bulk verification results
See Error handling for the full list of status codes and response formats.
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}

Next steps

Verify emails in bulk

Start a batch verification and get back the batch id.

Verify a single email

Check whether one email address is valid and deliverable.

Webhooks

Get notified automatically when a batch completes instead of polling.

Credits & billing

See how credits are consumed for each endpoint.