Skip to main content
GET
GET
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

string
required
The id returned from the POST request

Response

200 — Verification completed

object
Batch metadata
object
Batch statistics
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.
object
Batch metadata
object
Batch progress

Error Responses

See Error handling for the full list of status codes and response formats.

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.