Skip to main content
GET
GET
Retrieve results of a previously submitted bulk phone search. Authenticate every request with your API key in the x-api-key header.
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 finished

object
Batch metadata
object
Batch statistics
array
Array of search results

200 — Search ongoing

object
id and status: "ongoing"
object
requested and finished counts

Error Responses

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

Next steps

Find phones in bulk

Submit a new batch of phone number searches.

Get a single result

Retrieve the result of a single phone search by id.

Webhooks

Get notified automatically when a batch completes.

Credits & billing

See how credits are consumed and refunded.