curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B919876543210&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/calleridvalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("Caller name:", data.name);
import requests
r = requests.get(
"https://lookup.proweblook.com/api/v1/calleridvalidation",
params={"phone_number": "+14155552671", "api_key": "YOUR_API_KEY"}
)
data = r.json()
print(f"Name: {data.get('name', 'Not found')}")
{
"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"]
}
{
"success": true,
"number": "+1 415 555 2671",
"name": null,
"valid": "VALID_CONFIRMED",
"line_type": "Mobile",
"carrier": "AT&T",
"countrycode": "US",
"countryname": "United States",
"countrycodenum": 1,
"formatnational": "(415) 555-2671",
"formatinternational": "+1 415 555 2671",
"location": "California",
"timezone": ["America/Los_Angeles"]
}
{
"success": false,
"message": "Invalid phone number"
}
{
"error": "Insufficient callerinfo API credits."
}
API Reference
Caller ID Lookup
Perform a reverse phone lookup to retrieve the registered name associated with a phone number.
GET
/
api
/
v1
/
calleridvalidation
curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"
curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B919876543210&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/calleridvalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("Caller name:", data.name);
import requests
r = requests.get(
"https://lookup.proweblook.com/api/v1/calleridvalidation",
params={"phone_number": "+14155552671", "api_key": "YOUR_API_KEY"}
)
data = r.json()
print(f"Name: {data.get('name', 'Not found')}")
{
"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"]
}
{
"success": true,
"number": "+1 415 555 2671",
"name": null,
"valid": "VALID_CONFIRMED",
"line_type": "Mobile",
"carrier": "AT&T",
"countrycode": "US",
"countryname": "United States",
"countrycodenum": 1,
"formatnational": "(415) 555-2671",
"formatinternational": "+1 415 555 2671",
"location": "California",
"timezone": ["America/Los_Angeles"]
}
{
"success": false,
"message": "Invalid phone number"
}
{
"error": "Insufficient callerinfo API credits."
}
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
string
required
The phone number to look up. Accepts local or international format.
string
required
Your ProWebLook API key. See Authentication.
string
Optional. The end-user’s IP address for logging purposes. Defaults to
0.0.0.0.Response
boolean
true if the lookup was successful, false otherwise.string
The phone number in international format.
string
The registered name associated with the phone number (Caller ID). May be
null if not found.string
Phone number validation status:
VALID_CONFIRMED or INVALID.string
The type of phone line (e.g.,
Mobile, Fixed Line).string
The mobile carrier/operator name.
string
ISO 3166-1 alpha-2 country code.
string
Full country name.
integer
Numeric country calling code.
string
National phone number format.
string
International phone number format.
string
Geographic location of the phone number.
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"
curl "https://lookup.proweblook.com/api/v1/calleridvalidation?phone_number=%2B919876543210&api_key=YOUR_API_KEY"
const response = await fetch(
"https://lookup.proweblook.com/api/v1/calleridvalidation?" +
new URLSearchParams({
phone_number: "+14155552671",
api_key: "YOUR_API_KEY"
})
);
const data = await response.json();
console.log("Caller name:", data.name);
import requests
r = requests.get(
"https://lookup.proweblook.com/api/v1/calleridvalidation",
params={"phone_number": "+14155552671", "api_key": "YOUR_API_KEY"}
)
data = r.json()
print(f"Name: {data.get('name', 'Not found')}")
{
"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"]
}
{
"success": true,
"number": "+1 415 555 2671",
"name": null,
"valid": "VALID_CONFIRMED",
"line_type": "Mobile",
"carrier": "AT&T",
"countrycode": "US",
"countryname": "United States",
"countrycodenum": 1,
"formatnational": "(415) 555-2671",
"formatinternational": "+1 415 555 2671",
"location": "California",
"timezone": ["America/Los_Angeles"]
}
{
"success": false,
"message": "Invalid phone number"
}
{
"error": "Insufficient callerinfo API credits."
}