Skip to main content
POST
POST
Run multiple phone searches in a single request. Up to 3,000 searches per batch. Authenticate every request with your API key in the x-api-key header. To find a single phone number, use the Find Single Phone endpoint. Each search needs to contain either:
  • The URL of a person’s LinkedIn profile (e.g., https://www.linkedin.com/in/michael-scott/)
  • The combination of individual information: firstname + lastname + (company_name or company_domain)
The LinkedIn URL will always prevail on the individual information if both are present.

Request Body

array of objects
required
Search payloads for which to find corresponding phone numbers.
object
Custom params that will be returned in the GET response and in the webhook notification.
object
Settings relative to the whole bulk search.

Response

201 — Bulk search created

string
Confirmation message
string
Unique identifier for this batch. Use this to retrieve results via the GET endpoint.
number
Total credits consumed. See Credits & billing for per-endpoint costs.
number
Estimated processing time in minutes (not guaranteed)
object
Credit breakdown

Error Responses

When credits are insufficient, the bulk endpoint returns HTTP 402 with a body of the form { "message": "..." }. See Error handling for the full list of status codes and response formats.

Next steps

Get bulk results

Retrieve the found phone numbers using the batch id.

Find a single phone

Run a single phone search from a LinkedIn URL or name and company.

Webhooks

Get notified automatically when a bulk search completes.

Credits & billing

See how credits are consumed for each endpoint.