Skip to main content
POST
POST
Run an asynchronous search to find a phone number and the associated country. Authenticate every request with your API key in the x-api-key header. The 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, as it is the best way to discriminate a single person and avoid homonym-related issues.

Request Body

Option 1 (Recommended):
string
LinkedIn profile URL of the person.Note: Takes precedence over individual information if both are provided.
Option 2:
string
First name of the person
string
Last name of the person
string
Company domain (e.g., "dundermifflin.com")
string
Company name (alternative to company_domain)
Additional:
string
A custom value you can use to reference an internal ID. It will be present in the results.
object
Settings related to this search.

Response

201 — Single search created

string
Confirmation message
string
Unique identifier for this search. Use this to retrieve results via the GET endpoint.
number
Number of credits consumed (50 by default; may vary by plan). See Credits & billing for per-endpoint costs.
object
Credit breakdown

Error Responses

On insufficient credits (402), the response body is { "reason": "...", "success": false }. See Error handling for the full list of status codes and response formats.

Next steps

Get the result

Retrieve the found phone number using the search id.

Find phones in bulk

Run multiple phone searches in a single request.

Authentication

How to pass your API key in the x-api-key header.

Webhooks

Get notified automatically when a search completes.