Skip to main content
GET
/
api
/
v1
/
phonevalidation
curl "https://lookup.proweblook.com/api/v1/phonevalidation?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"],
  "ratelimit_remain": 100,
  "ratelimit_seconds": 100
}

​
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 both GET and POST requests.

​
Request Parameters

​
phone_number
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).
​
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, 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

​
status
string
Validation result. Either VALID_CONFIRMED or INVALID.
​
formatted_number
string
Phone number in E.164 international format (e.g., +1 415 555 2671).
​
linetype
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.
​
carrier
string
The name of the mobile carrier/operator (e.g., T-Mobile, Vodafone). May be empty for landlines.
​
location
string
Geographic description of the number (city, region, or country).
​
countrycodenum
integer
Numeric country calling code (e.g., 1 for US, 44 for UK, 91 for India).
​
countrycode
string
ISO 3166-1 alpha-2 country code (e.g., US, GB, IN).
​
countryname
string
Full country name (e.g., United States, India).
​
formatnational
string
Phone number in national format (e.g., (415) 555-2671).
​
formatinternational
string
Phone number in international format (e.g., +1 415 555 2671).
​
timezone
array
Array of IANA timezone strings applicable to this number (e.g., ["America/New_York"]).
​
ratelimit_remain
integer
Remaining rate limit calls in the current window.
​
ratelimit_seconds
integer
Seconds until the rate limit window resets.

​
Credit Cost

1 credit is deducted from your phoneapi_balance per successful validation. 
curl "https://lookup.proweblook.com/api/v1/phonevalidation?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"],
  "ratelimit_remain": 100,
  "ratelimit_seconds": 100
}