> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# global_phone_lookup Tool

> Look up international phone numbers outside North America

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

<ParamField body="internationalCode" type="string" required>
  Country calling code without the `+` sign (e.g., `"44"` for UK, `"49"` for
  Germany, `"81"` for Japan).
</ParamField>

<ParamField body="phone" type="string" required>
  Phone number without the country code (e.g., `"2079460123"` for a UK number).
</ParamField>

<ParamField body="loginId" type="string">
  API key. Only required if not provided via the `x-dncscrub-api-key` HTTP
  header.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the API call succeeded.
</ResponseField>

<ResponseField name="country" type="string">
  Full country name.
</ResponseField>

<ResponseField name="countryCode" type="string">
  2-letter ISO country code.
</ResponseField>

<ResponseField name="regionCode" type="string">
  Region/state/province code.
</ResponseField>

<ResponseField name="regionName" type="string">
  Full region/state/province name.
</ResponseField>

<ResponseField name="city" type="string">
  City name.
</ResponseField>

<ResponseField name="timezone" type="string">
  Timezone name.
</ResponseField>

<ResponseField name="utcOffset" type="string">
  UTC offset string.
</ResponseField>

<ResponseField name="hasDST" type="string">
  DST indicator.
</ResponseField>

<ResponseField name="latitude" type="string">
  Latitude coordinate.
</ResponseField>

<ResponseField name="longitude" type="string">
  Longitude coordinate.
</ResponseField>

<ResponseField name="numberType" type="string">
  Type of number (mobile, landline, etc).
</ResponseField>

<ResponseField name="carrier" type="string">
  Carrier/operator name.
</ResponseField>

<ResponseField name="language" type="string">
  Primary language in the region.
</ResponseField>

<ResponseField name="errorCode" type="string">
  Machine-readable error code (when failed).
</ResponseField>

<ResponseField name="errorMessage" type="string">
  Human-readable error description (when failed).
</ResponseField>

## Examples

<Tabs>
  <Tab title="Request (UK)">
    ```json theme={null}
    {
      "internationalCode": "44",
      "phone": "2079460123"
    }
    ```
  </Tab>

  <Tab title="Response">
    ```json theme={null}
    {
      "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"
    }
    ```
  </Tab>
</Tabs>

## Common Country Codes

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