Skip to content
All endpoints

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

  • phonestringrequired

    Phone number in E.164 or international format (aliases number and phone_number also accepted; spaces, parentheses, and hyphens are stripped automatically).

    Example: +18002428478

  • freshstring

    Set 1 or true on 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"

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.

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.