IP Locator:Request

← Global IP

A request consists of a protocol to make a call to the service, detailing desired elements. The minimum required elements in a request are your Customer ID (License Key) and at least one input IP address.

IP Locator supports JSON and REST protocols.

Field Names

This is a list of the request field names and their protocol naming conventions.

Field Name	Level	REST	JSON
Transmission Reference	Request	t	TransmissionReference
Customer ID		id	CustomerID
Record ID	Record		RecordID
IP Address		ip	IPAddress
Output Columns		cols	Cols

Request Elements

The following elements set the basic options for each request. These apply to the entire request, not the individual records.

Transmission Reference

Optional.

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

Protocol	Syntax
JSON	"TransmissionReference":"string"
REST	?t = string

Customer ID

Required.

This is a string value containing the License Key issued to the customer by Melissa Data for IP Locator.

If this element is absent, the Web Service will return an error. To receive a License Key, please contact your Melissa Data sales representative at 1-800-MELISSA.

Protocol	Syntax
JSON	"CustomerID":"string"
REST	&id = string

Request Record Elements

JSON will contain the Records element.

Protocol	Definition
JSON	Each IP address will be contained within [{}] under the Records element.
REST	The REST interface only allows a single record per request.

RecordID

Optional.

This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.

Protocol	Syntax
JSON	"RecordID":"string"

IPAddress

Required.

The IP address to be verified.

Both IPv4 and IPv6 Input Formats are supported. For example:

IPv4: 127.0.0.1
IPv6: 2001:db8:85a3:0:0:8a2e:370:7334

Protocol	Syntax
JSON	"IPAddress":"string"
REST	&ip = string

Output Columns

Optional.

Return full or partial domain information.

For example:

• &cols=grpdomaininfo will return the full domain information.
• While &cols=DomainCountry,DomainAgeEstimated,DomainAddress1,DomainAdministrativeArea will only return the selected domain output columns.

Protocol	Syntax
JSON	"Cols":"string"
REST	&cols = string