Check WhatsApp Account Exists (by Full Number)

View All WhatsApp Number Validation & Profile Lookup APIs →

Lightweight existence check for a single number — returns whether the phone number is registered on WhatsApp, without fetching full profile details. Cheaper than a full profile lookup. Pass the full international number (with or without +, spaces, dashes, or 00 prefix); the backend parses it with libphonenumber. isExist can be true, false, or null (indeterminate — retry after a short backoff). When isExist=true, the response includes hasExtra (enrichment fields available for this number: always avatar and about, plus sparse deviceName / email / waOldDeviceName when known) and a userHash that must be passed to the profile/extra endpoints (Get Avatar / Get About / Get Device Name / Get Email / Get Previous Device Name / Get Business Profile / Get Presence) to authorize the heavier lookup. The userHash is valid for 24 hours.

API Features

Real-time existence check Query live registration status to know instantly whether a number is on WhatsApp before messaging or enriching records
Auto country-code split Backend parses the full number with libphonenumber and echoes the national phone so you can verify the parse
Issues a userHash When the number exists, returns a userHash used to authorize profile and sparse-extra lookups (valid 24 hours)
hasExtra field map Lists which enrichment endpoints can return a value for this number (avatar, about, and sparse deviceName/email/waOldDeviceName when known)
Lightweight & cheap Returns only a yes/no plus userHash and hasExtra; no heavy profile payload, ideal for bulk pre-checks

Live API Demo

GET /api/project/whatsapp/check-exist-by-phone

API Response (JSON)

{}
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

View Subscription Plans →