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