curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl -X POST "https://lookup.proweblook.com/api/v1/phonevalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/phonevalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log(data);
$params = http_build_query([
'phone_number' => '+14155552671',
'api_key' => 'YOUR_API_KEY',
]);
$response = file_get_contents("https://lookup.proweblook.com/api/v1/phonevalidation?$params");
$data = json_decode($response, true);
{
"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"],
"ratelimit_remain": 100,
"ratelimit_seconds": 100
}
{
"status": "INVALID"
}
{
"error": "Invalid API key."
}
{
"error": "Insufficient phone API credits."
}
API Reference
Phone Validation
Validate and enrich a phone number with carrier, line type, location, timezone, and more.
GET
/
api
/
v1
/
phonevalidation
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl -X POST "https://lookup.proweblook.com/api/v1/phonevalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/phonevalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log(data);
$params = http_build_query([
'phone_number' => '+14155552671',
'api_key' => 'YOUR_API_KEY',
]);
$response = file_get_contents("https://lookup.proweblook.com/api/v1/phonevalidation?$params");
$data = json_decode($response, true);
{
"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"],
"ratelimit_remain": 100,
"ratelimit_seconds": 100
}
{
"status": "INVALID"
}
{
"error": "Invalid API key."
}
{
"error": "Insufficient phone API credits."
}
Overview
The Phone Validation API accepts a phone number (with optional country code) and returns detailed metadata including formatting, carrier information, line type, geographic location, and timezone data. This endpoint supports bothGET and POST requests.
Request Parameters
string
required
The phone number to validate. Can be provided in E.164 format (
+14155552671) or local format (e.g., 4155552671 with a country code hint).string
required
Your ProWebLook API key. See Authentication.
string
ISO 3166-1 alpha-2 country code hint (e.g.,
US, IN, GB). If omitted or set to none, the API will attempt to auto-detect the country from the number itself.Defaults to auto-detection.Response
string
Validation result. Either
VALID_CONFIRMED or INVALID.string
Phone number in E.164 international format (e.g.,
+1 415 555 2671).string
The type of phone line. Possible values:
Mobile, Fixed Line, Fixed Line or Mobile, Toll-Free, Premium Rate, Shared Cost, VoIP, Personal Number, Pager, Universal Access Number, Voicemail, Unknown.string
The name of the mobile carrier/operator (e.g.,
T-Mobile, Vodafone). May be empty for landlines.string
Geographic description of the number (city, region, or country).
integer
Numeric country calling code (e.g.,
1 for US, 44 for UK, 91 for India).string
ISO 3166-1 alpha-2 country code (e.g.,
US, GB, IN).string
Full country name (e.g.,
United States, India).string
Phone number in national format (e.g.,
(415) 555-2671).string
Phone number in international format (e.g.,
+1 415 555 2671).array
Array of IANA timezone strings applicable to this number (e.g.,
["America/New_York"]).integer
Remaining rate limit calls in the current window.
integer
Seconds until the rate limit window resets.
Credit Cost
1 credit is deducted from yourphoneapi_balance per successful validation.
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl -X POST "https://lookup.proweblook.com/api/v1/phonevalidation" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155552671",
"api_key": "YOUR_API_KEY"
}'
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=9876543210&country_code=IN&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/phonevalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log(data);
$params = http_build_query([
'phone_number' => '+14155552671',
'api_key' => 'YOUR_API_KEY',
]);
$response = file_get_contents("https://lookup.proweblook.com/api/v1/phonevalidation?$params");
$data = json_decode($response, true);
{
"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"],
"ratelimit_remain": 100,
"ratelimit_seconds": 100
}
{
"status": "INVALID"
}
{
"error": "Invalid API key."
}
{
"error": "Insufficient phone API credits."
}