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.

Headers

Acceptstringrequired

Format of the response.

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

Example:application/json

Content-Typestringrequired

Format of the request.

Value:"application/json"

Bodyapplication/jsonrequired

TransmissionReferencestring

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

CustomerIDstringrequired

Required. The License Key issued by Melissa.

Columnsstring

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.

grpdomaininfo
- DomainAddress1
- DomainAdministrativeArea
- DomainAgeEstimated
- DomainAvailability
- DomainCountry
- DomainCountryCode
- DomainCreatedDate
- DomainEmail
- DomainExpirationDate
- DomainLocality
- DomainOrganization
- DomainPostalCode
- DomainPrivateProxy
- DomainUpdatedDate

RecordsArray of objects, [ 1 .. 100 ] itemsrequired

curl -i -X POST \
  https://globalip.melissadata.net/v4/WEB/IPLocation/doIPLocation \
  -H 'Accept: application/json' \
  -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

Response

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