---
title: "Perform GeoIP database lookup"
method: GET
path: "/api/geoip"
---

# Perform GeoIP database lookup

`GET /api/geoip`

## Query parameters

- `ip` string
- `locale` string
- `edition` string

## Response `200`

Success

- GeoIpLookupResult
  - `ip` string, required
  - `info` GeoIpInfo
    - `continent_id` number
    - `continent_code` string
    - `continent_name` string
    - `country_id` number
    - `country_iso_code` string
    - `country_name` string
    - `subdivisions` GeoNameSubdivision[]
      - `id` number
      - `iso_code` string
      - `name` string
    - `city_id` number
    - `city_name` string
    - `metro_code` number
    - `postal_code` string
    - `timezone` string
    - `posix_timezone` string
    - `latitude` number
    - `longitude` number
    - `accuracy_radius` number
    - `is_in_european_union` boolean
    - `is_anonymous_proxy` boolean
    - `is_anycast` boolean
    - `is_satellite_provider` boolean
    - `autonomous_system_number` number
    - `autonomous_system_organization` string
  - `elapsed` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-07-17** `6c4b1d51a3cd` — 1 info
  - added the optional property `info/longitude` to the response with the `200` status
- **2025-12-02** `9205b9758bc5` — 2 info
  - added the non-success response with the status `401`
  - added the optional property `info/posix_timezone` to the response with the `200` status
- **2025-12-01** `72d45ef4b78b` — 1 info
  - the endpoint scheme security `bearer` was added to the API
- **2025-11-27** `f0cea1fdb9b6` — 1 info
  - endpoint added
- **2025-11-26** `da18e3ec2edb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/quoi-dev/apis/geoip-service/changes/api/geoip/get.md)

---

[API](https://skmtc.dev/quoi-dev/apis/geoip-service.md) · [All operations](https://skmtc.dev/quoi-dev/apis/geoip-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quoi-dev/geoip-service/revisions/6c4b1d51a3cd/schema)