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

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

Example:t=Test

idstring, (password)required

Required. The License Key issued by Melissa.

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

ipstringrequired

Required. The IP Address to verify.

Example:ip=216.231.3.166

colsstring

Columns - Specify what domain information to return.

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

Acceptstringrequired

Format of the response.

Enum:"application/json""*/*"

Example:application/json

Content-Typestringrequired

Format of the request.

Value:"application/json"

curl -i -X GET \
  'https://globalip.melissadata.net/v4/WEB/IPLocation/doIPLocation?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&ip=216.231.3.166' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'

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

Response

{
  "Version": "6.2.0.1122",
  "TransmissionReference": "IP Locator Test",
  "TransmissionResults": "",
  "Records": [
    { … }
  ]
}