---
title: "Retrieve detailed geolocation information for a visitor’s or user’s IP address"
method: GET
path: "/geo/ip"
tags: ["Geo"]
---

# Retrieve detailed geolocation information for a visitor’s or user’s IP address

`GET /geo/ip`

## Request

- Base URL: `https://v2.greipapi.com`
- URL: `https://v2.greipapi.com/geo/ip`
- Auth: HTTP bearer

This API allows you to retrieve detailed geolocation information for a visitor’s or user’s IP address.

By using the IP Geolocation method, you can access data such as the user’s country, city, ISP, and more, enabling you to personalize user experiences, enhance security, and make data-driven decisions based on geographic insights.

## 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 `Geo` 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/geo/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)