Skip to content
Global Phone/
/
Validate phone numbers

Global Phone

Overview

The Global Phone Cloud API features real-time phone validation allowing detection of unregistered phone numbers, to help improve the quality of the phone data in your database as well as understand the regions your contacts are located. Verify, correct, and append data to phone numbers in over 230 countries and territories.

You can use Global Phone to:

  • Verify and append country dialing codes, international exit codes, national prefixes, and more.
  • Append geographic information on the telephone line such as latitude, longitude, administrative area, and language.
  • Parse the phone number into its various components.
  • Return Caller ID Information for 200 countries.
  • Identify the number’s phone type including mobile, landline, VoIP, and more. (North America Only)
  • Perform a real-time check on a number to know whether it is live or not. (North America Only)

Documentation

Useful Resources

Product Page

https://www.melissa.com/phone-verification

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
global-phone.json
global-phone.yaml
Languages
Servers
Global Phone Server
https://globalphone.melissadata.net/v4/WEB/GlobalPhone/

Phone Number Validation

Use this endpoint to verify, correct, and append data to phone numbers.

Operations

Validate a phone number

Request

This is the Global Phone single request.

Note: A License Key and Phone Number are both required for this request.

Query
tstring

Transmission Reference - Serves as a unique identifier for this set of records. This allows you to match a response to a request.

Example: t=Test
idstring(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
optstring

Options - Pass in options you want to set for the request.

List options in the format OptionName:Parameter, with multiple options delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter

  • CallerID:< False | True > - Adds the CallerID to the queried phone, if we found it to be valid (US and Canada Only). Default is False.
  • DefaultCallingCode:<Country-Calling-Code> - The sequence of digits found after the leading +. Blank by Default. This is used when the country could not be detected from the phone number or country input.
  • EnableBatchSuggestion:< False | True > - (Batch Mode Only) Enables records to be corrected using the suggestions engine when there is exactly only 1 suggestion found. Default is False.
  • PreferDialingCode:< False | True > - When there is a mismatch between a phone dialing code (the “+” prefix in a phone number) and country name this controls which is prioritized. Default is True.
  • TimeToWait:< [1-30] > - Select how long (in seconds) that you would like our Cloud API to wait on a single request before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Default set to 2.
  • VerifyPhone:< Express | Premium > - This sets the level of verification to be done on a phone check.
    • Express - Quickly validates against database of known phone numbers. This is the default option.
    • Premium - Validates against a database of known phone numbers. If a number was last real-time validated more than 180 days ago, then a real-time check will be performed.
Example: opt=TimeToWait:5,CallerID:True
phonestringrequired

Phone Number - The phone number to be verified.

Example: phone=8006354772
ctrystring

Country - The suspected country of the input phone number. Official name or ISO2 code.

Example: ctry=US
ctryOrgstring

Country of Origin - Where the verification is being done. If this differs from the Country, the output number will be changed to a callable format from the country of origin.

Example: ctryOrg=US
curl -i -X GET \
  'https://globalphone.melissadata.net/v4/WEB/GlobalPhone/doGlobalPhone?id={REPLACE-WITH-YOUR-LICENSE-KEY}&phone=8006354772'

Responses

Global Phone Response

Bodyapplication/json
Versionstring

Current revision number of Global Phone.

TransmissionReferencestring

A unique identifier for this set of records. Returned as sent.

TransmissionResultsstring

Returns result codes for the request as a whole. For more information, see Global Phone Result Codes.

RecordsArray of objects(doGlobalPhoneRecords)

Records array.

Response
application/json
{
  "Version": "9.4.0.1273",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Records": [
    { … }
  ]
}

Validate phone numbers

Request

This is the Global Phone batch request.

Note: A License Key and Phone Number are both required for this request.

Bodyapplication/jsonrequired

This is the Global Phone batch request body. You can send up to 10 phone numbers in a single request.

TransmissionReferencestring

Transmission Reference - This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Example: "Test"
Optionsstring

Options - Pass in options you want to set for the request.

List options in the format OptionName:Parameter, with multiple options delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter

  • CallerID:< False | True > - Adds the CallerID to the queried phone, if we found it to be valid (US and Canada Only). Default is False.
  • DefaultCallingCode:<Country-Calling-Code> - The sequence of digits found after the leading +. Blank by Default. This is used when the country could not be detected from the phone number or country input.
  • EnableBatchSuggestion:< False | True > - (Batch Mode Only) Enables records to be corrected using the suggestions engine when there is exactly only 1 suggestion found. Default is False.
  • PreferDialingCode:< False | True > - When there is a mismatch between a phone dialing code (the “+” prefix in a phone number) and country name this controls which is prioritized. Default is True.
  • TimeToWait:< [1-30] > - Select how long (in seconds) that you would like our Cloud API to wait on a single request before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Default set to 2.
  • VerifyPhone:< Express | Premium > - This sets the level of verification to be done on a phone check.
    • Express - Quickly validates against database of known phone numbers. This is the default option.
    • Premium - Validates against a database of known phone numbers. If a number was last real-time validated more than 180 days ago, then a real-time check will be performed.
Example: "TimeToWait:5,CallerID:True"
CustomerIDstringrequired

The License Key issued by Melissa.

Example: "{REPLACE-WITH-YOUR-LICENSE-KEY}"
RecordsArray of objects[ 1 .. 100 ] itemsrequired

Array of phone numbers to be validated.

Records[].​RecordIDstring

A unique identifier for the current record.

Example: "1"
Records[].​PhoneNumberstringrequired

Phone Number - The phone number to be verified.

Example: "8006354772"
Records[].​Countrystring

Country - The suspected country of the input phone number. Official name or ISO2 code.

Example: "US"
Records[].​CountryOfOriginstring

Country of Origin - Where the verification is being done. If this differs from the Country, the output number will be changed to a callable format from the country of origin.

curl -i -X POST \
  https://globalphone.melissadata.net/v4/WEB/GlobalPhone/doGlobalPhone \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "Test",
    "Options": "",
    "CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Records": [
      {
        "RecordID": "1",
        "PhoneNumber": "1-800-635-4772",
        "Country": "US",
        "CountryOfOrigin": ""
      },
      {
        "RecordID": "2",
        "PhoneNumber": "+44 (0)20 7718 0070",
        "Country": "UK",
        "CountryOfOrigin": ""
      }
    ]
  }'

Responses

Global Phone Response

Bodyapplication/json
Versionstring

Current revision number of Global Phone.

TransmissionReferencestring

A unique identifier for this set of records. Returned as sent.

TransmissionResultsstring

Returns result codes for the request as a whole. For more information, see Global Phone Result Codes.

RecordsArray of objects(doGlobalPhoneRecords)

Records array.

Response
application/json
{
  "Version": "9.4.0.1273",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Records": [
    { … },
    { … }
  ]
}