Mobile Phone Finder API (V2 - Clay Compatible)

V2 of the Mobile Phone Finder — Clay-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
Learn how to use this API inside Claude: Watch Video

💳 Credit Usage: 5 credits per found phone number, 0 when none is found. 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: they depend on your plan. Every response reports your limits and what is left of them in the X-RateLimit-* headers, and a 429 carries Retry-After — see Rate limits and quotas.

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