global_phone_lookup Tool - Contact Center Compliance

The global_phone_lookup tool provides detailed information about international phone numbers outside North America. It returns country, region, carrier, timezone, and geographic coordinates.

When to Use

If you are only calling in North America, use other tools instead
Determining timezone and location for international contacts
Identifying carrier and line type for international numbers

Parameters

string

required

Country calling code without the + sign (e.g., "44" for UK, "49" for Germany, "81" for Japan).

string

required

Phone number without the country code (e.g., "2079460123" for a UK number).

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

Response

boolean

Whether the API call succeeded.

string

Full country name.

string

2-letter ISO country code.

string

Region/state/province code.

string

Full region/state/province name.

string

City name.

string

Timezone name.

string

UTC offset string.

string

DST indicator.

string

Latitude coordinate.

string

Longitude coordinate.

string

Type of number (mobile, landline, etc).

string

Carrier/operator name.

string

Primary language in the region.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Examples

Request (UK)
Response

{
  "internationalCode": "44",
  "phone": "2079460123"
}

{
  "success": true,
  "country": "United Kingdom",
  "countryCode": "GB",
  "regionCode": "ENG",
  "regionName": "England",
  "city": "London",
  "timezone": "Europe/London",
  "utcOffset": "+00:00",
  "hasDST": "Y",
  "latitude": "51.5074",
  "longitude": "-0.1278",
  "numberType": "Landline",
  "carrier": "BT",
  "language": "English"
}

Common Country Codes

Country	Code
United Kingdom	44
Germany	49
France	33
Japan	81
Australia	61
India	91
Brazil	55
Mexico	52

​When to Use

​Parameters

​Response

​Examples

​Common Country Codes

When to Use

Parameters

Response

Examples

Common Country Codes