Mobile Phone Finder API (V2 - For Clay)

V2 of the Mobile Phone FinderClay-compatible. Behaves exactly like /v1/people/mobile-phone-finder, except that when no person or phone is found it returns HTTP 200 with an envelope { status, error, data } and data: null (instead of the v1 404).
Search Options:
    • LinkedIn Search: Provide only the linkedin URL (no need for domain/name)
    • Domain + Name Search: Provide both domain and name (no need for LinkedIn)

Recommended for Clay: gracefully returns HTTP 200 for both found and not-found cases, which is what Clay expects when enriching leads. Learn how to use this API inside Clay: Watch Video

💳 Credit Usage: 5 credits per result (charged when a phone is found), 0 otherwise. The charged amount is also returned in the X-Credit response header (e.g. -5.0), present only on the charged (phone found) response.

Real errors (400 / 402 / 500) and gateway errors (401 / 429) are returned as-is with their real HTTP status — they are not wrapped.

🔗 Related Endpoints:
  • Mobile Phone Finder (V1) — same pricing, 404 on not-found
  • Export Single Person with Email (V2 – Clay Compatible) — verified email in the same Clay flow (1 credit)

Rate limits: 5 requests per second by default. Customers using more than 450,000 credits per month can get custom rate limits — contact us at [email protected] or via the in-app chat.

The header Content-Type: application/json must be included in the request.

Body Params
uri
Defaults to https://www.linkedin.com/in/robin-hennessey-4183b328

The person's full LinkedIn profile URL. Alternative to domain + name.

string

Company domain name. Must be provided together with name.

string

The person's full name — use together with domain when no LinkedIn URL is available.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json