---
title: "Get the full information of a given IP address"
method: GET
path: "/lookup/ip/{ip}"
tags: ["Lookup"]
---

# Get the full information of a given IP address

`GET /lookup/ip/{ip}`

## Request

- Base URL: `https://v2.greipapi.com`
- URL: `https://v2.greipapi.com/lookup/ip/{ip}`
- Auth: HTTP bearer

Use this API to retrieve comprehensive information about a given IP address. It provides details such as location, ISP, and potential risk factors, enabling you to analyze and verify IP data for enhanced security, fraud prevention, and user profiling.

## Path parameters

- `ip` string, required

## Query parameters

- `params` string
- `lang` string
- `callback` string
- `format` string
- `mode` string
- `source` string
- `amount` string
- `user_id` string

## Response `200`

OK

- GeoIpLookupSuccess
  - `success` boolean, required
  - `data` GeoLookupData, required: Geo/IP lookup payload (modules depend on params).
    - `ip` GeoIpModule: IP metadata returned on geo/IP lookups.
      - `address` string
      - `version` integer
      - `numeric` integer
      - `bogon` boolean
    - `geo` GeoGeoModule: Geolocation fields returned on geo/IP lookups.
      - `continent` string
      - `continent_code` string
      - `country` string
      - `country_code` string
      - `region` string
      - `city` string
      - `postal` string
      - `latitude` number
      - `longitude` number
    - `asn` GeoAsnModule
      - `number` string: Autonomous System Number (for example AS15169).
      - `cidr` string, nullable: Longest matching CIDR block for the looked-up IP on the resolved ASN, or null when none matches.
      - `name` string
      - `org` string
      - `phone` string
      - `email` string
      - `domain` string
      - `created` string
      - `type` string: ASN classification.
  - `execution_ms` integer, required

## Changes

- **2026-11-03** `5ef5b288383a`: 14 info
  - api tag `Lookup` added
  - added the optional property `data/geo/city` to the response with the `200` status
  - added the optional property `data/geo/continent` to the response with the `200` status
  - added the optional property `data/geo/continent_code` to the response with the `200` status
  - …10 more
- **2026-10-21** `d5aa0ccd9a4a`: 2 info
  - added the new optional `query` request parameter `amount`
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `9346ce4dfd7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/greip/apis/greip-api/changes/lookup/ip/:ip/get.md)

---

[API](https://skmtc.dev/greip/apis/greip-api.md) - [All operations](https://skmtc.dev/greip/apis/greip-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greip/apis/greip-api/revisions/5ef5b288383a?raw)