curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl -X POST "https://lookup.proweblook.com/api/v1/wavalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/wavalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("On WhatsApp:", data.numberstatus);
console.log("Business:", data.businessnumber);
{
"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
}
{
"status": "VALID_CONFIRMED",
"formatted_number": "+91 98765 43210",
"linetype": "Mobile",
"carrier": "Jio",
"location": "India",
"countrycodenum": 91,
"countrycode": "IN",
"countryname": "India",
"formatnational": "098765 43210",
"formatinternational": "+91 98765 43210",
"timezone": ["Asia/Calcutta"],
"numberstatus": true,
"businessnumber": true
}
{
"status": "INVALID",
"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": false,
"businessnumber": false
}
{
"error": "Insufficient WA API credits."
}
{
"status": false,
"error": "WA validation provider is temporarily unavailable. Please retry."
}
API Reference
WhatsApp Validation
Validate a phone number and check if it has an active WhatsApp account, including business account detection.
GET
/
api
/
v1
/
wavalidation
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl -X POST "https://lookup.proweblook.com/api/v1/wavalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/wavalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("On WhatsApp:", data.numberstatus);
console.log("Business:", data.businessnumber);
{
"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
}
{
"status": "VALID_CONFIRMED",
"formatted_number": "+91 98765 43210",
"linetype": "Mobile",
"carrier": "Jio",
"location": "India",
"countrycodenum": 91,
"countrycode": "IN",
"countryname": "India",
"formatnational": "098765 43210",
"formatinternational": "+91 98765 43210",
"timezone": ["Asia/Calcutta"],
"numberstatus": true,
"businessnumber": true
}
{
"status": "INVALID",
"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": false,
"businessnumber": false
}
{
"error": "Insufficient WA API credits."
}
{
"status": false,
"error": "WA validation provider is temporarily unavailable. Please retry."
}
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 bothGET and POST requests.
Request Parameters
string
required
The phone number to check. Provide in E.164 format (
+14155552671) or local format with a country code hint.When sending raw GET URLs, always URL-encode the leading
+ as %2B. If you use fetch, URLSearchParams, requests, or any normal HTTP client query builder, this is handled automatically.string
required
Your ProWebLook API key. See Authentication.
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
string
WhatsApp validation result:
VALID_CONFIRMED (number is on WhatsApp) or INVALID.string
Phone number in international format.
string
Line type (e.g.,
Mobile, Fixed Line, VoIP).string
Mobile carrier or operator name.
string
Geographic description (city/region/country).
integer
Numeric country calling code.
string
ISO 3166-1 alpha-2 country code.
string
Full country name.
string
National format of the phone number.
string
International format of the phone number.
array
Array of IANA timezone strings.
WhatsApp-Specific Fields
boolean
true if the number is registered on WhatsApp, false otherwise. A false value is returned only for a definitive provider result.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 yourwabalance 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"
curl -X POST "https://lookup.proweblook.com/api/v1/wavalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/wavalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/wavalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("On WhatsApp:", data.numberstatus);
console.log("Business:", data.businessnumber);
{
"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
}
{
"status": "VALID_CONFIRMED",
"formatted_number": "+91 98765 43210",
"linetype": "Mobile",
"carrier": "Jio",
"location": "India",
"countrycodenum": 91,
"countrycode": "IN",
"countryname": "India",
"formatnational": "098765 43210",
"formatinternational": "+91 98765 43210",
"timezone": ["Asia/Calcutta"],
"numberstatus": true,
"businessnumber": true
}
{
"status": "INVALID",
"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": false,
"businessnumber": false
}
{
"error": "Insufficient WA API credits."
}
{
"status": false,
"error": "WA validation provider is temporarily unavailable. Please retry."
}