---
title: "Returns information about the provided IP."
method: GET
path: "/lookup/{ip}"
---

# Returns information about the provided IP.

`GET /lookup/{ip}`

## Request

- Base URL: `https://iplocate.io/api`
- URL: `https://iplocate.io/api/lookup/{ip}`
- Auth: API key in query parameter `apikey`

Provides comprehensive information about a specified IP address, including geographic location (city, region, country), coordinates, postal code, timezone, currency code, calling code.
It also provides ASN (Autonomous System Number) details, company information, privacy and threat information (VPN, proxy detection, Tor, relay, hosting, etc.), abuse contact information.
This endpoint is useful for applications needing detailed IP intelligence, such as identifying geographic origin, privacy status, and potential abuse reporting information.

## Path parameters

- `ip` string, required

## Query parameters

- `include` string

## Response `200`

Lookup response object.

- LookupResponse
  - `ip` string
  - `country` string, nullable
  - `country_code` string, nullable
  - `is_eu` boolean
  - `city` string, nullable
  - `continent` string, nullable
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `time_zone` string, nullable
  - `postal_code` string, nullable
  - `subdivision` string, nullable
  - `currency_code` string, nullable
  - `calling_code` string, nullable
  - `is_anycast` boolean
  - `is_satellite` boolean
  - `asn` object, nullable
    - `asn` string
    - `route` string
    - `netname` string
    - `name` string
    - `country_code` string
    - `domain` string
    - `type` string
    - `rir` string
  - `privacy` object
    - `is_abuser` boolean
    - `is_anonymous` boolean
    - `is_bogon` boolean
    - `is_hosting` boolean
    - `is_icloud_relay` boolean
    - `is_proxy` boolean
    - `is_tor` boolean
    - `is_vpn` boolean
  - `company` object, nullable
    - `name` string
    - `domain` string
    - `country_code` string
    - `type` string
  - `hosting` object, nullable
    - `provider` string, nullable
    - `domain` string, nullable
    - `network` string, nullable
    - `region` string, nullable
    - `service` string, nullable
  - `abuse` object, nullable
    - `address` string, nullable
    - `country_code` string, nullable
    - `email` string, nullable
    - `name` string, nullable
    - `network` string, nullable
    - `phone` string, nullable

## Other responses

- `400`: Invalid IP address.
- `403`: Unknown token or invalid permission.
- `404`: Not found. Please check the IP address.
- `429`: API quota has been reached for the token. Visit https://iplocate.io/pricing.
- `500`: Internal server error or server unavailable.

---

[API](https://skmtc.dev/iplocate/apis/iplocate-io.md) · [All operations](https://skmtc.dev/iplocate/apis/iplocate-io/llms.txt) · [OpenAPI document](https://skmtc.dev/iplocate/apis/iplocate-io/revisions/9f4d9cf31e4b?raw)