Skip to main content
GET
GET
Retrieve all results from a batch email search using the batch ID. Authenticate every request with your API key in the x-api-key header. The batch ID is the id returned when you start a job with the Find 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 — Search completed

object
Batch metadata
object
Batch statistics
array
Array of search results

200 — Search still in progress

While the batch is running, the GET endpoint returns HTTP 200 with a reduced body of the shape { general: { id, status: "ongoing" }, stats: { finished, requested } }.
object
id and status: "ongoing"
object
finished and requested counts

Error Responses

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

Next steps

Find emails in bulk

Start a new batch of up to 5,000 email searches.

Webhooks

Skip polling and get notified when a batch completes.

Credits & billing

See how credits are charged and refunded per result.

Verify emails in bulk

Validate a list of email addresses in a single batch.