Phone Finder
Get Bulk Phone Results
Retrieve results, status, and stats for a bulk phone number search batch by id
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 requestResponse
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 countsError 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.

