---
title: "Ip2Geo - Get Conversions"
method: POST
path: "/conversions/get"
---

# Ip2Geo - Get Conversions

`POST /conversions/get`

Retrieve multiple conversions by their IDs.

## Query parameters

- `select` string[]

## Request body

- object
  - `conversionIds` string[], required — Array of conversion IDs to retrieve.

## Response `200`

Conversions retrieved successfully.

- GetConversionsResponse
  - `success` boolean, required — Whether the request was successful.
  - `message` string, required — Response message.
  - `code` integer, required — HTTP status code.
  - `data` object
    - `conversions` Conversion[] — Array of conversions.
      - `id` integer — Internal conversion ID
      - `uniqueId` string, uuid — Unique identifier for the conversion.
      - `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.
              - …
            - `city` object, nullable
              - …
            - `flag` object, nullable
              - …
            - `currency` object, 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
      - `status` string — Conversion status (success, failed, invalid-ip-address).
      - `startedAt` string, date-time — When the conversion started.
      - `completedAt` string, date-time, nullable — When the conversion completed.
      - `createdAt` string, date-time — When the conversion was created.
  - `_req` RequestMeta, required
    - `reqId` string, required — Unique request identifier.
    - `resTime` number, required — Response time in milliseconds.

## Other responses

- `400` — Bad request - missing or invalid conversion IDs!
- `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)