---
title: "Returns IP information about the current IP."
method: GET
path: "/"
tags: ["general"]
---

# Returns IP information about the current IP.

`GET /`

## Request

- Base URL: `https://ipinfo.io`
- URL: `https://ipinfo.io/`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
  - API key in query parameter `token`
- TypeScript: <https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/docs/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns IP information about the current IP.

## Response `200`

Full response object.

- FullResponse
  - `ip` string, required
  - `bogon` boolean
  - `hostname` string
  - `city` string
  - `region` string
  - `country` string
  - `loc` string
  - `postal` string
  - `timezone` string
  - `org` string
  - `asn` AsnResponse
    - `asn` string, required
    - `name` string, required
    - `country` string
    - `allocated` string, date
    - `registry` 'arin' | 'ripe' | 'apnic' | 'lacnic' | 'afrinic'
    - `domain` string, required
    - `num_ips` integer
    - `route` string
    - `type` 'isp' | 'business' | 'education' | 'hosting' | 'government', required
    - `prefixes` Prefix[]
      - `netblock` string, required
      - `id` string, required
      - `name` string, required
      - `country` string, required
      - `size` string
      - `status` string
      - `domain` string, nullable
      - `rpki_status` 'valid' | 'invalid' | 'unknown'
    - `prefixes6` Prefix6[]
      - `netblock` string, required
      - `id` string, required
      - `name` string, required
      - `country` string, required
      - `size` string
      - `status` string
      - `domain` string
      - `rpki_status` 'valid' | 'invalid' | 'unknown'
    - `peers` string[]
    - `upstreams` string[]
    - `downstreams` string[]
  - `company` CompanyResponse
    - `name` string, required
    - `domain` string, required
    - `type` 'isp' | 'business' | 'education' | 'hosting' | 'government', required
  - `carrier` CarrierResponse
    - `name` string, required
    - `mcc` string, required
    - `mnc` string, required
  - `privacy` PrivacyResponse
    - `vpn` boolean, required
    - `proxy` boolean, required
    - `tor` boolean, required
    - `hosting` boolean, required
    - `relay` boolean, required
    - `service` string, required
  - `domains` DomainsResponse
    - `ip` string
    - `page` integer
    - `total` integer, required
    - `domains` string[]

## Other responses

- `403`: Unknown token or invalid permission. We return the same error for blocking malicious IP addresses as well.
- `429`: Allocated API rate limit has been reached for the token. The user will be prompted with options to increase their API limit.
- `500`: Internal server error or server unavailable.

---

[API](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification.md) - [All operations](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/revisions/c63f11e4f26e?raw)