---
title: "Validate an IP address"
method: GET
path: "/doIPLocation"
tags: ["IP Address Locator"]
---

# Validate an IP address

`GET /doIPLocation`

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 parameters

- `t` string
- `id` string, password, required
- `ip` string, required
- `cols` string

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json', required

## Response `200`

Successful Response

- Response
  - `Version` string — The current service version number.
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Global IP Result Codes](https://docs.melissa.com/cloud-api/global-ip/result-codes.html).
  - `Records` ResponseRecord[]
    - `City` string — The city where the IP address is located.
    - `ConnectionSpeed` string — The connection speed associated with this IP address.
    - `ConnectionType` string — The type of connection used by this IP address.
    - `Continent` string — The continent where the IP address is located.
    - `CountryAbbreviation` string — The alpha-2 country code of the country where the IP address is located.
    - `CountryName` string — The full name of the country where the IP address is located.
    - `DomainAddress1` string — The Physical Address associated with the domain.
    - `DomainAdministrativeArea` string — The State or most common geographic data element associated with the domain
    - `DomainAgeEstimated` string — How long the domain has existed since its creation
    - `DomainAvailability` string — Status whether domain is available or unavailable
    - `DomainCountry` string — The full name of the country associated with the domain
    - `DomainCountryCode` string — The two character code for the country associated with the domain
    - `DomainCreatedDate` string — The Created Date of the domain
    - `DomainEmail` string — The email associated with the domain
    - `DomainExpirationDate` string — The expiration date of the domain
    - `DomainLocality` string — The City or most common population center associated with the domain
    - `DomainName` string — The domain name associated with this IP address.
    - `DomainOrganization` string — The Organization associated with the domain.
    - `DomainPostalCode` string — The Postal Code associated with the domain.
    - `DomainPrivateProxy` string — The Private Proxy associated with the domain.
    - `DomainUpdatedDate` string — The last time the domain was updated.
    - `DST` string — Daylight Savings Time.
    - `IPAddress` string — The IP address being looked up.
    - `ISPName` string — The name of the Internet Service Provider.
    - `Latitude` string — The latitude for the IP address.
    - `Longitude` string — The longitude for the IP address.
    - `PostalCode` string — The postal code where the IP address is located.
    - `ProxyDescription` string — Additional Details for the Proxy Type returned.
    - `ProxyType` string — The type of proxy for an IP Address.
    - `RecordID` string — ID of each input record.
    - `Region` string — Comma delimited status, error codes, and change codes for the record.
    - `Result` string — Returns a comma delimited list of result codes that provide more information from the service. For more information, see [Global IP Result Codes](https://docs.melissa.com/cloud-api/global-ip/result-codes.html).
    - `TimeZoneCode` string — The time zone code where the IP address is located.
    - `TimeZoneName` string — The time zone name where the IP address is located.
    - `UTC` string — The GMT offset for the area where the IP address is located.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/global-ip.md) · [All operations](https://skmtc.net/melissa/apis/global-ip/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/global-ip/versions/b00fbd97ea4f/schema)