---
title: "Validate a phone number"
method: GET
path: "/doGlobalPhone"
tags: ["Phone Number Validation"]
---

# Validate a phone number

`GET /doGlobalPhone`

This is the Global Phone single request.

**_Note:_** A License Key and Phone Number are both required for this request.

## Query parameters

- `t` string
- `id` string, password, required
- `opt` string
- `phone` string, required
- `ctry` string
- `ctryOrg` string

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json', required

## Response `200`

Global Phone Response

- DoGlobalPhoneResponse — This returns the record response.
  - `Version` string — Current revision number of Global Phone.
  - `TransmissionReference` string — A unique identifier for this set of records. Returned as sent.
  - `TransmissionResults` string — Returns result codes for the request as a whole. For more information, see [Global Phone Result Codes](https://docs.melissa.com/cloud-api/global-phone/result-codes.html).
  - `Records` DoGlobalPhoneRecords[] — Records array.
    - `RecordID` string — A unique identifier for the current record, if sent in the request.
    - `Results` string — Comma delimited string with any result codes for the record. For more information, see [Global Phone Result Codes](https://docs.melissa.com/cloud-api/global-phone/result-codes.html).
    - `PhoneNumber` string — Standardized phone number after a successful call to the service.
    - `AdministrativeArea` string — Administrative area associated with the inputted phone number.
    - `CountryAbbreviation` string — Abbreviation of the country for the inputted phone number.
    - `CountryName` string — Name of the country for the inputted phone number.
    - `Carrier` string — Name of the phone’s carrier.
    - `CallerID` string — Name appended to the targeted phone number.
    - `DST` string — Returns a ‘Y’ (for yes) or ‘N’ (for no) to distinguish whether the region of the inputted phone number observes daylight savings time.
    - `InternationalPhoneNumber` string — The number you would dial, given your output fields, in order to successfully send a call.
    - `Language` string — Predominant language of the phone’s detected geographical location.
    - `Latitude` string — Latitude of the geographically identifiable service area of the exchange.
    - `Locality` string — Locality (city) associated with the phone number passed to the Lookup function.
    - `Longitude` string — Longitude of the geographically identifiable service area of the exchange.
    - `PhoneInternationalPrefix` string — International exit code needed to call a number outside of the dialing country.
    - `PhoneCountryDialingCode` string — Country dialing code, the digit(s) dialed after the international prefix.
    - `PhoneNationPrefix` string — National prefix, must be dialed before an area (city) code when calling a number within the same country but outside the numbering area.
    - `PhoneNationalDestinationCode` string — National destination code that identifies a numbering area within a country (or group of countries) and/or network/services.
    - `PhoneSubscriberNumber` string — Subscriber number associated with the phone number passed in.
    - `UTC` string — Universal time code (UTC) for the time zone associated with the inputted phone number. (+/- hh:mm)
    - `PostalCode` string — US only. ZIP code that corresponds to a locality inside the United States.
    - `Suggestions` unknown[] — An array of Response Record Elements. This is for single-record requests only.
      - unknown
    - `TimeZoneCode` string — The 3-letter code for the time zone associated with the phone number.
    - `TimeZoneName` string — The full name of the 3-letter time zone code returned by the TimeZoneCode field.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/global-phone.md) · [All operations](https://skmtc.net/melissa/apis/global-phone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/global-phone/versions/f2188da38fc7/schema)