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.
post
https://api.ai-ark.com/api/developer-portal/v2/people/mobile-phone-finder