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

{
  "success": true,
  "number": "+1 415 555 2671",
  "name": "John Smith",
  "valid": "VALID_CONFIRMED",
  "line_type": "Mobile",
  "carrier": "T-Mobile",
  "countrycode": "US",
  "countryname": "United States",
  "countrycodenum": 1,
  "formatnational": "(415) 555-2671",
  "formatinternational": "+1 415 555 2671",
  "location": "California",
  "timezone": ["America/Los_Angeles"]
}

​
Overview

The Caller ID Validation API performs a reverse phone lookup, returning the name registered to a phone number. It first validates the number, then queries name databases — with priority lookup for Indian numbers (IN) and Israeli numbers (IL) — and falls back to a global CNAM lookup via the Seven network.

​
Request Parameters

​
phone_number
string
required
The phone number to look up. Accepts local or international format.
​
api_key
string
required
Your ProWebLook API key. See Authentication.
​
ip
string
Optional. The end-user’s IP address for logging purposes. Defaults to 0.0.0.0.

​
Response

​
success
boolean
true if the lookup was successful, false otherwise.
​
number
string
The phone number in international format.
​
name
string
The registered name associated with the phone number (Caller ID). May be null if not found.
​
valid
string
Phone number validation status: VALID_CONFIRMED or INVALID.
​
line_type
string
The type of phone line (e.g., Mobile, Fixed Line).
​
carrier
string
The mobile carrier/operator name.
​
countrycode
string
ISO 3166-1 alpha-2 country code.
​
countryname
string
Full country name.
​
countrycodenum
integer
Numeric country calling code.
​
formatnational
string
National phone number format.
​
formatinternational
string
International phone number format.
​
location
string
Geographic location of the phone number.
​
timezone
array
Array of IANA timezone strings applicable to this number.

​
Credit Cost

1 callerinfo credit (callerinfo_balance) is deducted per call.

​
Lookup Coverage

India (IN) & Israel (IL): Looked up first in ProWebLook’s proprietary name databases for faster, more accurate results.All other countries: Queried via the Seven.io global CNAM network.
curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"

{
  "success": true,
  "number": "+1 415 555 2671",
  "name": "John Smith",
  "valid": "VALID_CONFIRMED",
  "line_type": "Mobile",
  "carrier": "T-Mobile",
  "countrycode": "US",
  "countryname": "United States",
  "countrycodenum": 1,
  "formatnational": "(415) 555-2671",
  "formatinternational": "+1 415 555 2671",
  "location": "California",
  "timezone": ["America/Los_Angeles"]
}