Global IP Quickstart#

Introduction#

Welcome to the Global IP Cloud API by Melissa. This service 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.

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 IP lookups here for the full experience.

Check an IP#

Global IP can check to see if an IP address is valid.

Endpoint#

/V4/WEB/IPLocation/doIPLocation

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • POST JSON
curl -X GET "https://globalip.melissadata.net/v4/WEB/iplocation/doiplocation?\
&t=\
&id={{customerId}}\
&ip="216.231.3.166"\
&format=JSON" \
-H "Content-Type:application/json" \
-H "Accept:application/json"
curl -X POST "https://globalip.melissadata.net/v4/web/iplocation/doiplocation" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID":{{customerId}},
    "TransmissionReference":"",
    "Columns":"",
    "Records":
       [
          {
             "RecordID":"1",
             "IPAddress":"216.231.3.166"
          },
          {
             "RecordID":"2",
             "IPAddress":"10.10.10.1"
          }
       ]
    }'

Inputs and Outputs#

The table below shows the most common inputs and outputs for this endpoint.

For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.

  • GET JSON
  • POST JSON

Inputs

Outputs

Request Level Parameters

cols

id

ip

t

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Records

Record Level Response Fields

City

ConnectionSpeed

ConnectionType

Continent

CountryAbbreviation

CountryName

DomainAddress1

DomainAdministrativeArea

DomainAgeEstimated

DomainAvailability

DomainCountry

DomainCountryCode

DomainCreatedDate

DomainEmail

DomainExpirationDate

DomainLocality

DomainName

DomainOrganization

DomainPostalCode

DomainPrivateProxy

DomainUpdatedDate

DST

IPAddress

ISPName

Latitude

Longitude

PostalCode

ProxyDescription

ProxyType

RecordID

Region

Result

TimeZoneCode

TimeZoneName

UTC

Inputs

Outputs

Request Level Parameters

Columns

CustomerID

IPAddress

RecordID

TransmissionReference

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Records

Record Level Response Fields

City

ConnectionSpeed

ConnectionType

Continent

CountryAbbreviation

CountryName

DomainAddress1

DomainAdministrativeArea

DomainAgeEstimated

DomainAvailability

DomainCountry

DomainCountryCode

DomainCreatedDate

DomainEmail

DomainExpirationDate

DomainLocality

DomainName

DomainOrganization

DomainPostalCode

DomainPrivateProxy

DomainUpdatedDate

DST

IPAddress

ISPName

Latitude

Longitude

PostalCode

ProxyDescription

ProxyType

RecordID

Region

Result

TimeZoneCode

TimeZoneName

UTC