Skip to content
/IP Address Locator

Global IP

Overview

The Global IP Cloud API is able to validate IPv4 and IPv6 addresses and give you geographic information for it. This geographical data can place an IP address within a city and postal code. It can also tell you the connection type and speed.

Global IP can be used to:

  • Verify an IP address as valid.
  • Associate a physical location with an IP address.
  • Determine the location of a mobile phone's IP address.
  • Determine connection speed and type of an IP address.
  • Determine the Internet Service Provider of an IP address.
  • Detect proxies and return their type.

Documentation

Useful Resources

Product Page

https://www.melissa.com/ip-location

Support Center

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

Download OpenAPI description
global-ip.json
global-ip.yaml
Languages
Servers
Global IP Server
https://globalip.melissadata.net/v4/WEB/IPLocation/

IP Address Locator

Use this endpoint to locate and validate IP addresses.

Operations

Validate an IP address

Request

Uses HTTPS GET to accept one input record and returns the response in JSON format. This is useful for browser level or quick single queries.

Note: A request to the Global IP Cloud Service must consist of the Customer ID and an IP address to verify.

Query
tstring

Transmission Reference - Value passed through unchanged to the response for identification or any other purpose.

Example: t=Test
idstring(password)required

The License Key issued by Melissa.

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

The IP Address to verify.

Example: ip=216.231.3.166
colsstring

Columns - The column names or groups to be output.

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

For example: ColumnName,ColumnName.

Columns:

grpdomaininfo - Domain information
  • DomainAddress1
  • DomainAdministrativeArea
  • DomainAgeEstimated
  • DomainAvailability
  • DomainCountry
  • DomainCountryCode
  • DomainCreatedDate
  • DomainEmail
  • DomainExpirationDate
  • DomainLocality
  • DomainOrganization
  • DomainPostalCode
  • DomainPrivateProxy
  • DomainUpdatedDate
Example: cols=DomainCountryCode,DomainExpirationDate
curl -i -X GET \
  'https://globalip.melissadata.net/v4/WEB/IPLocation/doIPLocation?id={REPLACE-WITH-YOUR-LICENSE-KEY}&ip=216.231.3.166'

Responses

Successful Response

Bodyapplication/json
Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global IP Result Codes.

RecordsArray of objects(ResponseRecord)
Response
application/json
{
  "Version": "6.2.0.1122",
  "TransmissionReference": "IP Locator Test",
  "TransmissionResults": "",
  "Records": [
    { … }
  ]
}

Validate IP addresses

Request

Uses HTTPS POST to accept one or more input records and returns the response in JSON format. This is useful for bulk queries.

Note: A request to the Global IP Cloud Service must consist of the Customer ID and an IP address to verify.

Bodyapplication/jsonrequired
TransmissionReferencestring

Value passed through unchanged to the response for identification or any other purpose.

CustomerIDstringrequired

The License Key issued by Melissa.

Columnsstring

Columns - The column names or groups to be output.

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

For example: ColumnName,ColumnName.

  • grpdomaininfo

    • DomainAddress1
    • DomainAdministrativeArea
    • DomainAgeEstimated
    • DomainAvailability
    • DomainCountry
    • DomainCountryCode
    • DomainCreatedDate
    • DomainEmail
    • DomainExpirationDate
    • DomainLocality
    • DomainOrganization
    • DomainPostalCode
    • DomainPrivateProxy
    • DomainUpdatedDate
RecordsArray of objects(RequestRecord)[ 1 .. 100 ] itemsrequired
Records[].​RecordIDstring

A unique identifier for the current record. Use this to match the record submitted with the record returned.

Records[].​IPAddressstringrequired

The IP Address to verify.

curl -i -X POST \
  https://globalip.melissadata.net/v4/WEB/IPLocation/doIPLocation \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "Test",
    "CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Columns": "",
    "Records": [
      {
        "RecordID": "1",
        "IPAddress": "216.231.3.166"
      },
      {
        "RecordID": "2",
        "IPAddress": "10.10.10.1"
      }
    ]
  }'

Responses

Successful Response

Bodyapplication/json
Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global IP Result Codes.

RecordsArray of objects(ResponseRecord)
Response
application/json
{
  "Version": "6.2.0.1122",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Records": [
    { … },
    { … }
  ]
}