Skip to content
All endpoints

WhatsApp Number Validation (POST JSON)

POST/v1/enrich/whatsapp3 Credits / check (0 on synthetic invalid or error)($0.0003 / check ($0.12–$0.30 / 1K checks))· Updated 2026-11-16

Direct Answer · Engineering Summary

POST /v1/enrich/whatsapp (and alias POST /v1/whatsapp/validate) accepts JSON payloads ({ "phone": "+18002428478" }, or "number" / "phone_number"), automatically strips formatting punctuation into E.164, and returns on_whatsapp, business_account, whatsapp_id (<digits>@s.whatsapp.net), place ({ country_code, country_name, calling_code, region }), numbering_plan, and messaging_apps. Billing is 3 Credits per valid check ($0.12–$0.30 per 1,000 checks) with 0 Credits on synthetic test numbers or errors.

Honest Trade-Offs & Scope Boundaries

  • →Single-number synchronous JSON endpoint optimized for concurrent HTTP/2 bursts (up to 600 RPM / 15 RPS on Business tier).
  • →Synthetic/fictional test numbers (e.g., +1-555-01xx or <7 digits) are intercepted locally in <1ms with 0 Credits charged.
  • →Results persist in a 7-day (604,800s) cache; pass { "phone": "...", "fresh": true } on paid plans to bypass cache.

POST JSON variant of /v1/enrich/whatsapp (also mounted at POST /v1/whatsapp/validate). Accepts phone, number, or phone_number in the JSON body, normalizes spaces/hyphens into E.164, and returns WhatsApp registration status, Business account detection, WhatsApp JID, ITU country metadata, and E.164 numbering plan validation.

Example Request (cURL / Python / JavaScript)

curl -X POST "https://api.placesdataapi.com/v1/enrich/whatsapp" \
  -H "x-api-key: pd_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "<phone>"
  }'

Response Fields

WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.

FieldTypeSample / Notes
codeintegerGateway status code (0 for success).
statusstringResponse status ('ok').
dataWhatsappCheckData
phone_e164stringNormalized E.164 phone number with '+' prefix.
on_whatsappbooleanWhether the number is registered on WhatsApp.
is_registeredbooleanBoolean alias of on_whatsapp for SDK compatibility.
business_accountbooleanWhether the WhatsApp account is a Business account.
is_businessbooleanBoolean alias of business_account.
whatsapp_idstringCanonical WhatsApp JID (<digits>@s.whatsapp.net) when registered, else null.
wa_idstringDigits-only WhatsApp user ID when registered, else null.
placeWhatsappPlaceInfoITU international country and geographic region resolved from the E.164 calling code and area code.
country_codestringISO 3166-1 alpha-2 country code (e.g., 'US', 'CA', 'GB', 'BR').
country_namestringFull English country or territory name (e.g., 'United States', 'United Kingdom').
calling_codestringITU international dialing prefix with '+' (e.g., '+1', '+44', '+86').
regionstringGeographic macro-region (e.g., 'North America', 'Europe', 'Asia', 'South America').
numbering_planWhatsappNumberingPlanITU-T E.164 numbering plan validation and parsed national subscriber number.
valid_e164booleanWhether the phone number conforms to a valid, non-fictional ITU-T E.164 numbering plan.
country_codestringISO 3166-1 alpha-2 country code.
calling_codestringInternational calling prefix with '+'.
national_numberstringNational significant number stripped of international calling code.
messaging_appsWhatsappMessagingAppStatusStructured messaging app presence status.
whatsappobject
on_whatsappbooleanWhether the phone number has an active WhatsApp account.
business_accountbooleanWhether the account is a WhatsApp Business or verified commercial line.
whatsapp_idstringCanonical WhatsApp JID (<digits>@s.whatsapp.net) when registered, or null.
metaResponseMetaGateway execution, pagination, and credit billing metadata.
request_idstringUnique request trace identifier.
endpointstringNormalized gateway endpoint path.
countintegerNumber of records returned in data.
totalintegerTotal matching records available in the index (for search/nearby).
has_morebooleanWhether additional pages are available.
overall_ratingnumberAggregate business overall star rating (included on /v1/places/reviews when indexed).
review_countintegerTotal business review count across Google Maps (included on /v1/places/reviews when indexed).
user_ratings_totalintegerAlias of review_count (total business review count).
credits_chargedintegerCredits deducted for this API call (0 on empty results or errors).
cachedbooleanWhether the response was served from the sub-50ms Redis L1 / PostgreSQL 16 cache.
took_msintegerServer-side execution latency in milliseconds.

Status Codes

200
WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.