---
title: "Ip2Geo - Bulk Convert IPs"
method: POST
path: "/convert"
---

# Ip2Geo - Bulk Convert IPs

`POST /convert`

## Request body

- object
  - `ips` string[], required — Array of IPv4 or IPv6 addresses to lookup.

## Response `200`

Successful geolocation lookup.

- MultipleConvertResponse
  - `success` boolean, required — Whether the request was successful.
  - `message` string, required — Response message.
  - `code` integer, required — HTTP status code.
  - `data` object[], required
    - `ip` string, required — The IP address that was converted.
    - `conversion` 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
              - …
          - `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)