---
title: "Returns IP information about the current IP."
method: GET
path: "/lookup/me"
tags: ["ipinfo core", "ipinfo plus", "ipinfo max"]
---

# Returns IP information about the current IP.

`GET /lookup/me`

## Request

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

Returns IP information about the current IP. This single endpoint is shared across the Core, Plus, and Max tiers — the response shape (`CoreResponse`, `PlusResponse`, or `MaxResponse`) depends on the plan associated with your API token. There are no separate `/plus/*` or `/max/*` endpoints.

## Response `200`

Core, Plus, or Max response object, depending on your token's plan.

- union
  - CoreResponse
    - `ip` string, required
    - `hostname` string
    - `geo` object
      - `city` string
      - `region` string
      - `region_code` string
      - `country` string
      - `country_code` string
      - `continent` string
      - `continent_code` string
      - `latitude` number
      - `longitude` number
      - `timezone` string
      - `postal_code` string
    - `as` object
      - `asn` string
      - `name` string
      - `domain` string
      - `type` 'hosting' | 'isp' | 'education' | 'government' | 'business'
    - `is_place` boolean: Indicates whether the IP address is associated with a known public place. Core only ever returns this flag — Plus adds a place object with name and category, and Max adds the full set including ssid, latitude, and longitude.
    - `is_anonymous` boolean
    - `is_anycast` boolean
    - `is_hosting` boolean
    - `is_mobile` boolean
    - `is_satellite` boolean
  - PlusResponse
    - `ip` string, required
    - `geo` object
      - `city` string
      - `region` string
      - `region_code` string
      - `country` string
      - `country_code` string
      - `continent` string
      - `continent_code` string
      - `latitude` number
      - `longitude` number
      - `timezone` string
      - `postal_code` string
      - `dma_code` string
      - `geoname_id` string
      - `radius` integer
      - `last_changed` string, date
    - `place` object: Information about the physical public place matched to the IP address. Omitted when there's no matching public place. Plus returns only name and category — ssid, latitude, and longitude are Max-only.
      - `name` string
      - `category` string
    - `as` object
      - `asn` string
      - `name` string
      - `domain` string
      - `type` 'hosting' | 'isp' | 'education' | 'government' | 'business'
      - `last_changed` string, date
    - `mobile` object
      - `name` string
      - `mcc` string
      - `mnc` string
    - `anonymous` object
      - `name` string
      - `is_proxy` boolean
      - `is_relay` boolean
      - `is_tor` boolean
      - `is_vpn` boolean
    - `is_place` boolean: Indicates whether the IP address is associated with a known public place.
    - `is_anonymous` boolean
    - `is_anycast` boolean
    - `is_hosting` boolean
    - `is_mobile` boolean
    - `is_satellite` boolean
  - MaxResponse
    - `ip` string, required
    - `hostname` string
    - `geo` object, required
      - `city` string
      - `region` string
      - `region_code` string
      - `country` string
      - `country_code` string
      - `continent` string
      - `continent_code` string
      - `latitude` number
      - `longitude` number
      - `timezone` string
      - `postal_code` string
      - `dma_code` string
      - `geoname_id` string
      - `radius` integer
      - `last_changed` string, date
    - `place` object: Information about the physical public place matched to the IP address. Omitted when there's no matching public place, and may omit individual sub-fields (name, latitude, longitude) for categories with no fixed address, such as in_transit or in_flight.
      - `name` string
      - `category` string
      - `ssid` string
      - `latitude` number
      - `longitude` number
    - `as` object, required
      - `asn` string
      - `name` string
      - `domain` string
      - `type` 'hosting' | 'isp' | 'education' | 'government' | 'business'
      - `last_changed` string, date
    - `mobile` object: Mobile carrier information for the IP address. Empty object if the IP is not a mobile carrier IP.
      - `name` string
      - `mcc` string
      - `mnc` string
    - `anonymous` object, required
      - `name` string
      - `last_seen` string, date
      - `percent_days_seen` integer
      - `is_proxy` boolean
      - `is_relay` boolean
      - `is_tor` boolean
      - `is_vpn` boolean
      - `is_res_proxy` boolean
    - `is_place` boolean: Indicates whether the IP address is associated with a known public place.
    - `is_anonymous` boolean
    - `is_anycast` boolean
    - `is_hosting` boolean
    - `is_mobile` boolean
    - `is_satellite` boolean

## Other responses

- `403`: Forbidden error (authentication issues).
- `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)