WhatsApp Number & Business Account Check API
GET/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
GET /v1/enrich/whatsapp (and POST /v1/enrich/whatsapp, POST /v1/whatsapp/validate, GET /v1/whatsapp/check) verifies in real time whether any international E.164 phone number is registered on WhatsApp, detects WhatsApp Business accounts, resolves its canonical WhatsApp JID (<digits>@s.whatsapp.net), and returns ITU country/region and numbering_plan metadata across 195+ countries. Pricing is flat at 3 Credits per valid check ($0.12–$0.30 per 1,000 checks—68%+ cheaper than standalone number validators, with 0 Credits charged on synthetic/invalid numbers or errors). Warm 7-day Redis L1 + PostgreSQL 16 cache hits resolve in <25ms.
Honest Trade-Offs & Scope Boundaries
- →Validates public WhatsApp registration presence, JID, Business status, and ITU numbering plan metadata only; never sends messages or triggers recipient notifications.
- →Caches verified WhatsApp check results for 7 days (604,800s) for sub-25ms repeat lookups; paid accounts can pass ?fresh=1 to force a live upstream re-check.
- →Unpaid free-trial accounts can run unlimited cached checks up to their RPM limit and up to 5 uncached live lookups per hour before upgrading.
Validate in real time whether an international E.164 phone number is registered on WhatsApp, detect WhatsApp Business accounts, resolve its WhatsApp JID (<digits>@s.whatsapp.net), and return ITU country/region and numbering plan metadata. Also mounted at aliases POST /v1/whatsapp/validate, GET /v1/whatsapp/check, and GET /v1/places/whatsapp-check. Charges 3 Credits per valid E.164 check ($0.12–$0.30 / 1K checks; 0 Credits on synthetic invalid numbers or errors).
Parameters
phonestringrequiredPhone number in E.164 or international format (aliases
numberandphone_numberalso accepted; spaces, parentheses, and hyphens are stripped automatically).Example:
+18002428478freshstringSet
1ortrueon paid plans to bypass the 7-day (604,800s) verification cache.Example:
0
Example Request (cURL / Python / JavaScript)
curl "https://api.placesdataapi.com/v1/enrich/whatsapp?phone=%2B18002428478" \
-H "x-api-key: pd_live_your_api_key"import requests
res = requests.get(
"https://api.placesdataapi.com/v1/enrich/whatsapp?phone=%2B18002428478",
headers={"x-api-key": "pd_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.placesdataapi.com/v1/enrich/whatsapp?phone=%2B18002428478", {
headers: { "x-api-key": "pd_live_your_api_key" },
});
const data = await res.json();
console.log(data);Live Response Preview
{
"code": 0,
"provider": "https://placesdataapi.com",
"status": "ok",
"msg": "success",
"data": {
"phone_e164": "+18002428478",
"on_whatsapp": true,
"is_registered": true,
"business_account": true,
"is_business": true,
"whatsapp_id": "18002428478@s.whatsapp.net",
"wa_id": "18002428478",
"place": {
"country_code": "US",
"country_name": "United States",
"calling_code": "+1",
"region": "North America"
},
"numbering_plan": {
"valid_e164": true,
"country_code": "US",
"calling_code": "+1",
"national_number": "8002428478"
},
"messaging_apps": {
"whatsapp": {
"on_whatsapp": true,
"business_account": true,
"whatsapp_id": "18002428478@s.whatsapp.net"
}
}
},
"meta": {
"request_id": "req_gm_99201a4bc812",
"endpoint": "/v1/enrich/whatsapp",
"credits_charged": 3,
"cached": true,
"took_ms": 4
}
}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.