Quickstart

Quickstart#

Introduction#

Welcome to the Melissa Global Phone Cloud API. Verify phone numbers from over 230 countries and append useful geographic information. In North America you can perform premium real-time checks to distinguish live numbers and phone types.

The Global Phone Cloud API can:

  • 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)

Global Phone Rate Limiting#

The Global Phone Web Service Premium Mode only supports Real-Time validation of phone numbers. We currently do not support batch processing when the Premium Mode option is enabled. This restriction is in place to ensure Telco providers do not block our system when verifying phone numbers.

A maximum on 5 records per second is the rate limit for all Global Phone Premium users. Going over this limit will subject users to rate limiting (429 Errors) or disconnection of service.

New to Melissa Cloud APIs?#

We highly recommend first time users of our Cloud APIs to review our Using Melissa Cloud APIs section. It will cover critical topics like:

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Explore Melissa Lookups#

Check out Global Phone lookups here for the full experience.

Check a Phone Number#

Global Phone can check to see if a phone number is valid.

Endpoint#

/V4/WEB/GlobalPhone/doGlobalPhone

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • POST JSON
curl -X GET "http://globalphone.melissadata.net/V4/WEB/GlobalPhone/doGlobalPhone?\
&t=Test\
&id={{customerId}}\
&opt=\
&phone=1-800-635-4772\
&ctry=US\
&ctryOrg=" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X POST "http://globalphone.melissadata.net/V4/WEB/GlobalPhone/doGlobalPhone" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
      "TransmissionReference": "Test",
      "CustomerID": "{{customerId}}",
      "Options": "",
      "Records":
      [{
         "RecordID": "1",
         "PhoneNumber": "1-800-635-4772",
         "Country": "US",
         "CountryOfOrigin": ""
      },
      {
         "RecordID": "2",
         "PhoneNumber": "+44 (0)20 7718 0070",
         "Country": "UK",
         "CountryOfOrigin": ""
      }]
    }
   '
Contents