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>"
}'import requests
res = requests.post(
"https://api.placesdataapi.com/v1/enrich/whatsapp",
headers={"x-api-key": "pd_live_your_api_key"},
json={
"phone": "<phone>"
},
timeout=30,
)
print(res.json())const res = await fetch("https://api.placesdataapi.com/v1/enrich/whatsapp", {
method: "POST",
headers: { "x-api-key": "pd_live_your_api_key", "Content-Type": "application/json" },
body: JSON.stringify({
phone: "<phone>",
}),
});
console.log(await res.json());Response Fields
WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Gateway status code (0 for success). |
status | string | Response status ('ok'). |
data | WhatsappCheckData | |
phone_e164 | string | Normalized E.164 phone number with '+' prefix. |
on_whatsapp | boolean | Whether the number is registered on WhatsApp. |
is_registered | boolean | Boolean alias of on_whatsapp for SDK compatibility. |
business_account | boolean | Whether the WhatsApp account is a Business account. |
is_business | boolean | Boolean alias of business_account. |
whatsapp_id | string | Canonical WhatsApp JID (<digits>@s.whatsapp.net) when registered, else null. |
wa_id | string | Digits-only WhatsApp user ID when registered, else null. |
place | WhatsappPlaceInfo | ITU international country and geographic region resolved from the E.164 calling code and area code. |
country_code | string | ISO 3166-1 alpha-2 country code (e.g., 'US', 'CA', 'GB', 'BR'). |
country_name | string | Full English country or territory name (e.g., 'United States', 'United Kingdom'). |
calling_code | string | ITU international dialing prefix with '+' (e.g., '+1', '+44', '+86'). |
region | string | Geographic macro-region (e.g., 'North America', 'Europe', 'Asia', 'South America'). |
numbering_plan | WhatsappNumberingPlan | ITU-T E.164 numbering plan validation and parsed national subscriber number. |
valid_e164 | boolean | Whether the phone number conforms to a valid, non-fictional ITU-T E.164 numbering plan. |
country_code | string | ISO 3166-1 alpha-2 country code. |
calling_code | string | International calling prefix with '+'. |
national_number | string | National significant number stripped of international calling code. |
messaging_apps | WhatsappMessagingAppStatus | Structured messaging app presence status. |
whatsapp | object | |
on_whatsapp | boolean | Whether the phone number has an active WhatsApp account. |
business_account | boolean | Whether the account is a WhatsApp Business or verified commercial line. |
whatsapp_id | string | Canonical WhatsApp JID (<digits>@s.whatsapp.net) when registered, or null. |
meta | ResponseMeta | Gateway execution, pagination, and credit billing metadata. |
request_id | string | Unique request trace identifier. |
endpoint | string | Normalized gateway endpoint path. |
count | integer | Number of records returned in data. |
total | integer | Total matching records available in the index (for search/nearby). |
has_more | boolean | Whether additional pages are available. |
overall_rating | number | Aggregate business overall star rating (included on /v1/places/reviews when indexed). |
review_count | integer | Total business review count across Google Maps (included on /v1/places/reviews when indexed). |
user_ratings_total | integer | Alias of review_count (total business review count). |
credits_charged | integer | Credits deducted for this API call (0 on empty results or errors). |
cached | boolean | Whether the response was served from the sub-50ms Redis L1 / PostgreSQL 16 cache. |
took_ms | integer | Server-side execution latency in milliseconds. |
Status Codes
- 200
- WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.