---
title: "Ip2Geo - Convert IP"
method: GET
path: "/convert"
---

# Ip2Geo - Convert IP

`GET /convert`

## Query parameters

- `ip` string, ipv4, required

## Response `200`

Successful geolocation lookup.

- SingleConvertResponse
  - `success` boolean, required — Whether the request was successful.
  - `message` string, required — Response message.
  - `code` integer, required — HTTP status code.
  - `data` Ip
    - `ip` string, nullable — The IP address.
    - `type` 'ipv4' | 'ipv6', nullable — IP address type.
    - `is_eu` boolean, nullable — Whether the IP is located in the European Union.
    - `continent` object, nullable
      - `name` string, nullable
      - `code` string, nullable
      - `geoname_id` integer, nullable — GeoNames ID for the continent.
      - `country` object, nullable
        - `name` string, nullable
        - `code` string, nullable
        - `geoname_id` integer, nullable — GeoNames ID for the country.
        - `phone_code` string, nullable
        - `capital` string, nullable
        - `tld` string, nullable
        - `subdivision` object, nullable — State, province, or region information.
          - `name` string, nullable — Name of the state/province/region.
          - `code` string, nullable — ISO code for the subdivision (e.g., 'CA' for California).
        - `city` object, nullable
          - `name` string, nullable
          - `geoname_id` integer, nullable — GeoNames ID for the city.
          - `latitude` number, nullable
          - `longitude` number, nullable
          - `accuracy_radius` integer, nullable — Radius in kilometers around the coordinates where the IP is likely located.
          - `metro_code` integer, nullable — Metro area code (US only).
          - `postal_code` string, nullable
          - `timezone` object, nullable
            - `name` string, nullable
            - `time_now` string, nullable
        - `flag` object, nullable
          - `img` string, nullable
          - `emoji` string, nullable
          - `emoji_unicode` string, nullable
        - `currency` object, nullable
          - `name` string, nullable
          - `code` string, nullable
          - `symbol` string, nullable
    - `registered_country` object, nullable — The country where the IP address is registered (may differ from location country for VPNs, proxies, etc.).
      - `name` string, nullable — Name of the registered country.
      - `code` string, nullable — ISO country code of the registered country.
      - `geoname_id` integer, nullable — GeoNames ID for the registered country.
    - `asn` object, nullable
      - `number` integer, nullable
      - `name` string, nullable
    - `completion_time` object, nullable
      - `miliseconds` number, nullable
      - `seconds` number, nullable
  - `_req` RequestMeta, required
    - `reqId` string, required — Unique request identifier.
    - `resTime` number, required — Response time in milliseconds.

## Other responses

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

---

[API](https://skmtc.net/ip2geo/apis/ip2geo-convert-ip-api.md) · [All operations](https://skmtc.net/ip2geo/apis/ip2geo-convert-ip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ip2geo/ip2geo-convert-ip-api/versions/9fe65f25eb8f/schema)