Skip to main content
GET
/
api
/
v1
/
wavalidation
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"

{
  "status": "VALID_CONFIRMED",
  "formatted_number": "+1 415 555 2671",
  "linetype": "Mobile",
  "carrier": "T-Mobile",
  "location": "California",
  "countrycodenum": 1,
  "countrycode": "US",
  "countryname": "United States",
  "formatnational": "(415) 555-2671",
  "formatinternational": "+1 415 555 2671",
  "timezone": ["America/Los_Angeles"],
  "numberstatus": true,
  "businessnumber": false
}

​
Overview

The WhatsApp Validation API first validates the phone number (using the Phone Validation engine), then checks whether it is registered on WhatsApp. It returns both phone metadata and WhatsApp status in a single response. This endpoint supports both GET and POST requests.

​
Request Parameters

​
phone_number
string
required
The phone number to check. Provide in E.164 format (+14155552671) or local format with a country code hint.
​
api_key
string
required
Your ProWebLook API key. See Authentication.
​
country_code
string
ISO 3166-1 alpha-2 country code hint (e.g., US, IN). If omitted or none, auto-detection is used.

​
Response

​
Phone Data Fields

​
status
string
WhatsApp validation result: VALID_CONFIRMED (number is on WhatsApp) or INVALID.
​
formatted_number
string
Phone number in international format.
​
linetype
string
Line type (e.g., Mobile, Fixed Line, VoIP).
​
carrier
string
Mobile carrier or operator name.
​
location
string
Geographic description (city/region/country).
​
countrycodenum
integer
Numeric country calling code.
​
countrycode
string
ISO 3166-1 alpha-2 country code.
​
countryname
string
Full country name.
​
formatnational
string
National format of the phone number.
​
formatinternational
string
International format of the phone number.
​
timezone
array
Array of IANA timezone strings.

​
WhatsApp-Specific Fields

​
numberstatus
boolean
true if the number is registered on WhatsApp, false otherwise.
​
businessnumber
boolean
true if this WhatsApp account is a Business account, false if it is a personal account or not on WhatsApp.

​
Credit Cost

1 WA credit is deducted from your wabalance per successful call.
The underlying phone number validation does not consume phoneapi_balance when called via this endpoint — only WA credits are charged.
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"

{
  "status": "VALID_CONFIRMED",
  "formatted_number": "+1 415 555 2671",
  "linetype": "Mobile",
  "carrier": "T-Mobile",
  "location": "California",
  "countrycodenum": 1,
  "countrycode": "US",
  "countryname": "United States",
  "formatnational": "(415) 555-2671",
  "formatinternational": "+1 415 555 2671",
  "timezone": ["America/Los_Angeles"],
  "numberstatus": true,
  "businessnumber": false
}