
# IPinfo OpenAPI Specification

This page provides the [official IPinfo OpenAPI (Swagger)](/developers/openapi.yaml) specification, commonly searched for under terms such as: IPinfo Swagger, IPinfo API YAML, openapi.yaml, swagger.yaml, or Swagger/OpenAPI spec.

This specification is intended for integration demos, client generation, and any tooling that consumes standard OpenAPI/Swagger definitions.

You can access the raw OpenAPI YAML file here: [https://ipinfo.io/developers/openapi.yaml](/developers/openapi.yaml)

# IPinfo Developer Resource

The quickest and easiest way to get started with IPinfo is to use one of our [official libraries](/developers/libraries), which are available for many popular programming languages and frameworks. If you'd like to write your own library or interact directly with our API, then the documentation below can help you.

## Authentication

Your API token is used to authenticate you with our API and can be provided either as an HTTP Basic Auth username, a bearer token, or alternatively as a token URL parameter.

```bash
# With Basic Auth
curl -u $TOKEN: ipinfo.io

# With Bearer token
curl -H "Authorization: Bearer $TOKEN" ipinfo.io

# With token query parameter
curl ipinfo.io?token=$TOKEN
```

Authentication

## JSON Response

We try to automatically detect when someone wants to call our API versus view our website, and then we send back the appropriate JSON response rather than HTML. We do this based on the user agent for known popular programming languages, tools, and frameworks. However, there are a couple of other ways to force a JSON response when it doesn't happen automatically.

One is to append `/json` at the end of any request:

```bash
curl ipinfo.io/json
curl ipinfo.io/8.8.8.8/json
```

The other is to set the `Accept` header to `application/json`:

```bash
curl -H "Accept: application/json" ipinfo.io
curl -H "Accept: application/json" ipinfo.io/8.8.8.8
```

JSON Response

## IP Address Parameter

The API supports passing in a single IPv4 or IPv6 IP address. Alternatively, if you do not pass in any IP address, we'll return details for the calling address. This allows you to look up your own (or a visitor to your site) IP address details without knowing the IP address in advance.

```bash
# Get details for 8.8.8.8
curl ipinfo.io/8.8.8.8?token=$TOKEN

# Get details for 2001:4860:4860::8888
curl ipinfo.io/2001:4860:4860::8888?token=$TOKEN

# Get details for your own IP address, which'll be included in the response
curl ipinfo.io?token=$TOKEN
```

IP Address Parameter

## HTTPS/ SSL

Our API is available over a secure HTTPS connection for all users. Simply add `https://` to the request URLs to make the requests secure.

```bash
# Get details for your own IP address over HTTPS
curl https://ipinfo.io?token=$TOKEN
```

HTTPS/ SSL

## Rate Limits

IPinfo Lite offers unlimited access to our API.

Paid plans include monthly request limits with configurable alerts to help you stay in control. If you exceed your plan’s limit, you’ll receive a 429 HTTP status code—but with metered billing, you can automatically extend your usage without interruptions.

[Paid plans](/pricing) come with higher monthly limits, and configurable alerts.

Rate Limits

## Filtering Responses

You can filter the API response down to specific fields or objects by adding the field or object name to the URL. In the case of a field you'll get it returned in plaintext, and an object will get returned as JSON.

```bash
# Get json the org field as plaintext
curl ipinfo.io/8.8.8.8/org?token=$TOKEN
AS15169 Google Inc.

# Get just the city as plaintext
curl ipinfo.io/8.8.8.8/city?token=$TOKEN
Mountain View

# Get country ISO code as plaintext
curl ipinfo.io/8.8.8.8/country?token=$TOKEN
US
```

Filtering Responses

## JSONP/ CORS Requests

JSONP and CORS are supported, allowing you to use ipinfo.io entirely in client-side code. For JSONP you just need to specify the callback parameter, e.g. `http://ipinfo.io/?callback=callback&token=$TOKEN`.

### Request visitor data using Fetch API (Promise)

```javascript
fetch("https://ipinfo.io/json?token=$TOKEN")
  .then((response) => response.json())
  .then((jsonResponse) => console.log(jsonResponse.ip, jsonResponse.country));
```

### Request visitor data using Fetch API (Async/Await)

```javascript
const request = await fetch("https://ipinfo.io/json?token=$TOKEN");
const jsonResponse = await request.json();

console.log(jsonResponse.ip, jsonResponse.country);
```

### Request visitor data using JSONP

```html
<script>
  function recordData(data) {
    console.log(data.ip, data.country);
  }
</script>
<script src="https://ipinfo.io/json?callback=recordData"></script>
```

JSONP/ CORS Requests

## IPv6 API endpoint

IPinfo's API ensures seamless support for both IPv4 and IPv6 connection. However, for technical reasons, we use distinct API endpoints:

- IPv4 connection: [ipinfo.io](https://ipinfo.io/)
- IPv6 connection: [v6.ipinfo.io](https://v6.ipinfo.io/)

If you're on an IPv6 address, use the ### [v6.ipinfo.io](https://v6.ipinfo.io/) API endpoint, which functions identically to the standard IPv4 API. All API parameters and arguments are supported as usual.

Example:

```bash
curl https://v6.ipinfo.io
```

Our website, however, is fully dual-stacked, supporting both IPv4 and IPv6 natively through the [ipinfo.io](https://ipinfo.io/) domain. Our IP data download product always includes both IPv4 and IPv6 IP addresses in each individual database download. If you are looking up IPv6 addresses as an API parameter or input, you can do so simply as well. Usage of [v6.ipinfo.io](https://v6.ipinfo.io/) only applies to IPv6 traffic visiting our API service.

### Why Separate API Endpoints

By separating the API endpoints, we prevent unintended behavior when tools default to IPv6 (via AAAA records). This ensures you receive the expected address type for your query. Because if we have A and AAAA records for the domain (supporting both v4 and v6), the users would get their v6 address back when they go to ipinfo.io's API (internet services usually default to v6 if it’s available), which is not usually what they expect.

IPv6 API endpoint

## Updated API System

With the release of our [IPinfo Lite API service](https://ipinfo.io/lite), we are rolling out a new API system available at `https://api.ipinfo.io`. This API system is much more robust in handling billions of requests and addresses DNS level issues with IPv6 and IPv4 connections. We are actively developing the API system and [we welcome feedback and queries from our IPinfo user community](https://community.ipinfo.io/). It supports our existing authentication methods as well.

### IP Lookup query - IPinfo Lite API

```bash
curl http://api.ipinfo.io/lite/104.28.246.147?token=$TOKEN
```

```json
{
  "ip": "104.28.246.147",
  "asn": "AS13335",
  "as_name": "Cloudflare, Inc.",
  "as_domain": "cloudflare.com",
  "country_code": "SG",
  "country": "Singapore",
  "continent_code": "AS",
  "continent": "Asia"
}
```

### IP Lookup query - IPinfo Lite API Visitor/Use

The `/me` endpoint provides the IP information of the visitor the URL.

```bash
curl https://api.ipinfo.io/lite/me?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

### Simplified API system for IPv6 connections

Our new API system is dual stacked, making it easier for users on IPv6 connections. You can access the API seamlessly without needing to switch endpoints.

```bash
curl -6 https://api.ipinfo.io/lite/me?token=$TOKEN
```

```json
{
  "ip": "2602:f8de::",
  "asn": "AS53356",
  "as_name": "Free Range Cloud Hosting Inc.",
  "as_domain": "freerangecloud.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

```bash
curl -4 https://api.ipinfo.io/lite/me?token=$TOKEN
```

```json
{
  "ip": "102.135.36.0",
  "asn": "AS208485",
  "as_name": "Nese Mala trading as Moon Dc",
  "as_domain": "moondc.com",
  "country_code": "TR",
  "country": "Turkey",
  "continent_code": "AS",
  "continent": "Asia"
}
```

### Explicity IPv4 and IPv6 endpoint - IPinfo Lite API

For IPv4 connections, you can prepend the API endpoint with the subdomain `v4`.

```bash
curl https://v4.api.ipinfo.io/lite/me?token=$TOKEN
curl https://v4.api.ipinfo.io/lite/8.8.8.8?token=$TOKEN
```

For IPv6 connections, you can prepend the API endpoint with the subdomain `v6`.

```bash
curl https://v6.api.ipinfo.io/lite/me?token=$TOKEN
curl https://v6.api.ipinfo.io/lite/8.8.8.8?token=$TOKEN
```

Updated API System

Getting Started

# IPinfo Lite API Developer Resource

**Available for**: Every IPinfo user

The [IPinfo Lite API](https://ipinfo.io/lite) is our free-tier API access plan, which includes unlimited country-level geolocation information and unlimited basic ASN information. Geolocation information provided by the IPinfo Lite API service includes country and continent information, while ASN information includes ASN, organization name, and domain name.

The API has no daily or monthly limit and provides unlimited access. The API is based on our IPinfo IPinfo Lite IP database.

> You can access IPinfo Lite data as a downloadable dataset as well: **[IPinfo Lite IP Data Downloads](/developers/ipinfo-lite-database)**

IPinfo Lite API

# IPinfo Core API Developer Resource

The [IPinfo Core API](https://ipinfo.io/core) is our entry-level premium API access plan, which includes granular [geolocation information](/developers/data-types#geolocation-data), ASN information, network flags, and access to the [dedicated ASN API](/developers/asn).

- **Geolocation information**: City, Region/State, Country, Postal code etc.
- **ASN information**: ASN (Autonomous System Number), AS Name, ASN Domain and ASN Type
- **Network flags**: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

> You can access IPinfo Core data as a downloadable dataset as well: **[IPinfo Core IP Data Downloads](/developers/ipinfo-core-database)**

IPinfo Core API

# IPinfo Plus API Developer Resource

The [IPinfo Plus](https://ipinfo.io/plus) API is our most popular API service that provides detailed IP address data, including geolocation, ASN information, mobile carrier details, privacy-related flags and access to the [dedicated ASN API](/developers/asn).

- **Geolocation information**: City, Region/State, Country, Postal code etc. and accuracy radius and last change date.
- **ASN information**: ASN (Autonomous System Number), AS Name, ASN Domain, ASN Type and last change date
- **Anonymous IP address**: Identifies whether an IP address is associated with privacy services such as VPNs, proxies, Tor nodes, or relay services.
- **Carrier information**: Provides details about the mobile carrier, including the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC).
- **Network flags**: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

> You can access IPinfo Plus data as a downloadable dataset as well: **[IPinfo Plus IP Data Downloads](/developers/ipinfo-plus-database)**

IPinfo Plus API

# IPinfo Enterprise

Our IPinfo Enterprise plan includes access to everything in IPinfo Business plan plus `IP Whois`, `IP Ranges`, `IP Activity` and full `domains` hosted on the IP. 

**IP Ranges API**

```bash
curl https://ipinfo.io/ranges/comcast.net?token=$TOKEN
```

```json
{
  "domain": "comcast.net",
  "num_ranges": "37330",
  "ranges": [
    "23.24.240.0/29",
    "23.24.240.64/29",
    "23.24.240.128/28",
    "23.24.240.152/29",
    "23.24.240.168/29",
    "23.24.240.192/29",
    "23.24.240.208/29",
    "23.24.241.40/29",
    "23.24.241.72/29",
    "23.24.241.96/29",
    "23.24.241.112/28",
    "23.24.241.136/29",
    "23.24.241.168/29",
    "23.24.241.184/29",
    ...
   ]
}
```

**Hosted Domains API**

The [Hosted Domains API](/data/hosted-domains) in the IPinfo Enterprise plan includes higher limits. Whereas in the IPinfo Business plan, you can only get five domains per page, in the IPinfo Enterprise plan, you can get up to 1000 domains.

```bash
curl https://ipinfo.io/domains/8.8.8.8?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "total": "37330",
  "domains": [
    "41.cn",
    "onionflix.cc",
    "newmax.info",
    "ftempurl.com",
    "itempurl.com",
    "authrock.com",
    "ctempurl.com",
    "mtqnia.com",
    "server-panel.net",
    "gtempurl.com",
    "htempurl.com",
    ...
   ]
}
```

IPinfo Enterprise API

# Documentation for IPinfo Residential Proxy Detection API

The IPinfo Residential Proxy Detection API provides detailed insights into IP addresses associated with residential, mobile, or datacenter proxy networks, including activity patterns, and service identification.

> You can access IPinfo IP to Residential Proxy Detection data as a downloadable dataset as well: **[IPinfo Residential Proxy Data Downloads](/developers/ip-to-residential-proxy)**

Residential Proxy API

# Documentation for IPinfo IP to Privacy Detection (Extended) API

The IPinfo IP to Privacy Detection (Extended) API service provides detection methodology related metadata to support risk scoring, confidence metrics, and IP reputation aspects behind each IP address that IPinfo detects to be anonymous.

IPinfo uses multi-modal detection methods to detect anonymous IP addresses, which includes internet measurement, IP address behavior and characteristics, internet records metadata, etc. This multi-data detection method makes for a robust detection process and can be used to fine-tune fraud detection models based on the risk models of companies.

> You can access IPinfo Anonymous IP Detection (Extended) data as a downloadable dataset as well: **[Privacy Detection Extended Data Downloads](/developers/privacy-detection-extended)**

Privacy Extended API

# ASN API Developer Resource

**Available in**: IPinfo Core, IPinfo Plus, IPinfo Business, and IPinfo Enterprise

ASN API allows you to programmatically access details about an ASN, such as the assigned prefixes, related domain, and more. The ASN API is available at `/ASXX/json`.

```bash
curl ipinfo.io/AS7922/json?token=$TOKEN
```

```json
{
  "asn": "AS7922",
  "name": "Comcast Cable Communications, LLC",
  "country": "US",
  "allocated": "1997-02-14",
  "registry": "arin",
  "domain": "comcast.com",
  "num_ips": 71224576,
  "type": "isp",
  "prefixes": [
    {
      "netblock": "104.69.216.0/22",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    },
    {
      "netblock": "104.69.220.0/23",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    }
  ],
  "prefixes6": [
    {
      "netblock": "2601::/20",
      "id": "COMCAST6NET",
      "name": "Comcast Cable Communications, LLC",
      "country": "US"
    },
    {
      "netblock": "2603:2000::/20",
      "id": "COMCAST6NET",
      "name": "Comcast Cable Communications, LLC",
      "country": "US"
    },
    {
      "netblock": "2603:3000::/24",
      "id": "COMCAST6NET",
      "name": "Comcast Cable Communications, LLC",
      "country": "US"
    },
    {
      "netblock": "2a03:2880:d001::/48",
      "id": "IE-FACEBOOK-201100822",
      "name": "Facebook Ireland Ltd",
      "country": "IE"
    }
  ]
}
```

ASN API

# IP Ranges Developer Resource

**Available in**: IPinfo Enterprise

Our [IP address ranges API](/products/ranges-api) returns a list of all of the IP addresses ranges assigned to or operated by a company, identified by the provided domain name.

```bash
curl https://ipinfo.io/ranges/nytimes.com?token=$TOKEN
```

```json
{
  "domain": "nytimes.com",
  "redirects_to": null,
  "num_ranges": 24,
  "ranges": [
    "80.4.179.80/28",
    "97.67.74.80/29",
    "2a00:2381:2ebf::/56",
    "194.73.217.40/29",
    "2a00:2381:2ebf:100::/56",
    ...
  ]
}
```

Even though the foundational data of the IP ranges API is based on the [IP to Company Database](https://ipinfo.io/data/ip-company), the API accepts domain inputs that ultimately resolve to an organization's domain. The target domain that the input domain redirects to is mentioned in the `redirects_to` key.

```bash
curl https://ipinfo.io/ranges/times.com?token=$TOKEN
```

```json
{
  "domain": "times.com",
  "redirects_to": "nytimes.com",
  "num_ranges": 24,
  "ranges": [
    "80.4.179.80/28",
    "97.67.74.80/29",
    "2a00:2381:2ebf::/56",
    "194.73.217.40/29",
    "2a00:2381:2ebf:100::/56",
    ...
  ]
}
```

IP Ranges API

# Hosted Domains API Developer Resource

**Available in**: IPinfo Business, and IPinfo Enterprise

Our Hosted Domains, or [Reverse IP API](/data/hosted-domains) returns a list of all of the domains hosted on the provided IP address.

IPinfo Business tier users receive up to 5 domains per API request, while IPinfo Enterprise plan users receive up to 1,000 domains per API request.

```bash
curl "ipinfo.io/domains/198.35.26.96?token=$TOKEN"
```

```json
{
  "ip": "198.35.26.96",
  "total": 16596,
  "domains": [
    "wikipedia.org",
    "wikimedia.org",
    "wiktionary.org",
    "wikisource.org",
    "wikibooks.org"
    ...
  ]
}
```

Hosted Domains API

# IP Whois API Developer Resource

**Available in**: IPinfo Enterprise

IP Whois API allows you to programmatically access Whois data by IP, ID or domain. The API is available at `/whois`.

The `page` query parameter can be used to go through paginated records. `page` starts at 0 and the parameter is part of the response when included in the request. The API returns up to 50 records per page.

IP Whois API

IPinfo APIs

# IP Data Types Developer Resource

When you make a request to IPinfo using a token, the API returns all the data the token has access to for the target IP address.

> Please note that:
> 
> - `https://api.ipinfo.io` is used for updated API tiers: [IPinfo Lite](/developers/lite-api), [IPinfo Core](/developers/core-api) and [IPinfo Plus](/developers/plus-api).
> - `https://ipinfo.io` is used for legacy API tiers: [IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api).

## Geolocation Data

**Available in**: [IPinfo Lite](/developers/lite-api) (Limited), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api)

- Country-level geolocation data is offered in the [IPinfo Lite API](/developers/lite-api).
- The full IP geolocation response is available across all our [paid plans](/pricing).
- The [IPinfo Plus API service](/developers/plus-api) comes with [accuracy radius](/accuracy) and geolocation stability fields.

**[IPinfo Lite](/developers/lite-api)**

```bash
curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN
```

```json
{
  // ...
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

**[IPinfo Core](/developers/core-api)**

```bash
curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN
```

```json
{
  // ...
  "geo": {
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "postal_code": "94043",
    "dma_code": "807",
    "geoname_id": "5375480",
    "radius": 50
  },
  // ...
}
```

**[IPinfo Plus](/developers/plus-api)** (Includes `radius` and `last_changed` fields)

```bash
curl https://api.ipinfo.io/lookup/38.181.131.54?token=$TOKEN
```

```json
{
  // ...
  "geo": {
    "city": "Harmony Garden",
    "region": "Eastern",
    "region_code": "",
    "country": "Hong Kong",
    "country_code": "HK",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 22.26573,
    "longitude": 114.2487,
    "timezone": "Asia/Hong_Kong",
    "postal_code": "999077",
    "geoname_id": "12719613",
    "radius": 100,
    "last_changed": "2025-02-09"
  }
  // ...
}
```

**[IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api)**

```bash
curl https://ipinfo.io?token=$TOKEN
```

```json
{
  "ip": "54.246.228.58",
  "hostname": "ec2-54-246-228-58.eu-west-1.compute.amazonaws.com",
  "city": "Dublin",
  "region": "Leinster",
  "country": "IE",
  "loc": "53.3331,-6.2489",
  "org": "AS16509 Amazon.com, Inc.",
  "postal": "D02",
  "timezone": "Europe/Dublin"
}
```

Geolocation Data

## ASN Data

**Available in**: [IPinfo Lite](/developers/lite-api) (Limited), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api)

Along with details ASN information, the [paid API tiers](/pricing) provide access to the dedicated [ASN API service](/data/ip-asn) returns information related to the ASN (Autonomous System Number) of the current or queried IP. 

- In the [IPinfo Lite](/developers/lite-api) plan, the API will return the ASN, ASN Organization name, and ASN Domain name.
- In the [IPinfo Core](/developers/core-api) and [IPinfo Plus](/developers/plus-api) API tiers, you will have access to ASN, AS Organization name, ASN Domain name, and ASN type. This also includes access to the [ASN API service](/developers/asn) (ASN → ASN Information).
- In the [IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api) API services, you will have ASN, AS Organization name, ASN Domain name, ASN type, and ASN route/prefix information for the queried IP address. This also includes access to the [ASN API service](/developers/asn) for ASN Information.

**[IPinfo Lite](/developers/lite-api)**

```bash
curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN
```

```json
{
  //...
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  //...
}
```

**[IPinfo Core](/developers/core-api)**

```bash
curl https://api.ipinfo.io/lookup/177.155.240.88?token=$TOKEN
```

```json
  //...
{
  "as": {
    "asn": "AS52778",
    "name": "SANER TELECOM INFORMATICA LTDA ME",
    "domain": "vilanet.com.br",
    "type": "isp"
  }
  //...
}
```

**[IPinfo Plus](/developers/plus-api)**

```bash
curl https://api.ipinfo.io/lookup/177.155.240.88?token=$TOKEN
```

```json
  //...
{
  "as": {
    "asn": "AS52778",
    "name": "SANER TELECOM INFORMATICA LTDA ME",
    "domain": "vilanet.com.br",
    "type": "isp",
    "last_changed": "2025-03-09"
  }
  //...
}
```

**[IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api)**

```bash
curl https://ipinfo.io/8.8.8.8?token=$TOKEN
```

```json
{
  //...
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "business"
  }
  //...
}
```

In the [paid plans](https://ipinfo.io/pricing), you also get access to the standalone [ASN API](/developers/asn) service, which provides information on the queried ASN.

```bash
curl https://ipinfo.io/AS7922/json?token=$TOKEN
```

```json
{
  "asn": "AS7922",
  "name": "Comcast Cable Communications, LLC",
  "country": "US",
  "allocated": "1997-02-14",
  "registry": "arin",
  "domain": "comcast.com",
  "num_ips": 71224576,
  "type": "isp",
  "prefixes": [
    {
      "netblock": "104.69.216.0/22",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    },
    {
      "netblock": "104.69.220.0/23",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    }
  ],
  "prefixes6": [
    {
      "netblock": "2601::/20",
      "id": "COMCAST6NET",
      "name": "Comcast Cable Communications, LLC",
      "country": "US"
    },
    // ...
  ]
}
```

You can learn more about the ASN API from [its documentation page](/developers/asn).

ASN Data

## IP Privacy Detection Data

**Available in**: [IPinfo Core](/developers/core-api) (Limited), [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/#ipinfo-business), and [IPinfo Enterprise](/developers/#ipinfo-enterprise)

[Privacy Data](/data/proxy-vpn-detection) or anonymous IP data returns various methods used to mask a user's true IP address, including [VPN detection](/tools/vpn-providers-detected), proxy detection, tor usage, private relay usage, or a connection via a hosting provider, which could potentially be used to tunnel traffic, and mask the true IP address.

- The full anonymous IP flag response indicating whether an IP is a VPN, proxy, Tor exit node, relay, or hosting service along with the name of the anonymous IP service provider, is available in the [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api).
- A limited response is available on the [IPinfo Core](/developers/core-api) plan, showing if the IP address is an anonymous IP and whether it belongs to a hosting or data center service.
- [IPinfo Plus](/developers/plus-api) returns information related to the anonymous IP. However, it does not mention the name of the service.

**[IPinfo Core](/developers/core-api)**

```bash
curl https://ipinfo.io/lookup/164.90.184.99?token=$TOKEN
```

```json
{
  ...
  "is_anonymous": true,
  "is_hosting": true,
  ...
}
```

**[IPinfo Plus](/developers/plus-api)**

```bash
curl https://api.ipinfo.io/lookup/164.90.184.99?token=$TOKEN
```

```json
{
  //...
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  //...
}
```


**[IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api)**

```bash
curl https://ipinfo.io/164.90.184.99?token=$TOKEN
```

```json
{
  ...
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": "TunnelBear"
  }
  ...
}
```

IP Privacy Detection Data

## Carrier or Mobile IP Data

**Available in**: [IPinfo Core](/developers/core-api) (Partial), [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/#ipinfo-business), and [IPinfo Enterprise](/developers/#ipinfo-enterprise)

[Carrier Data](/data/ip-carrier) returns mobile or carrier-related information for the IP address. 

- In limited capability, [IPinfo Core](/developers/core-api) also contains IP to carrier information, flagging carrier IP addresses.
- The full IP to Carrier response is available across the [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api), which include the mobile carrier's name, its country code (MCC), and network code (MNC).

**[IPinfo Core](/developers/core-api)**

```bash
curl https://ipinfo.io/66.87.125.72?token=$TOKEN
```

```json
{
  //...
  "is_mobile": true,
  //...
}
```

**[IPinfo Plus](/developers/plus-api)**

```bash
curl https://api.ipinfo.io/lookup/1.39.203.0?token=$TOKEN
```

```json
{
  //...
  "mobile": {
    "name": "Vi India",
    "mcc": "404",
    "mnc": "22"
  }
  //...
}
```

**[IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api)**

```bash
curl https://ipinfo.io/66.87.125.72?token=$TOKEN
```

```json
{
  ...
  "carrier": {
    "name": "Sprint Corporation",
    "mcc": "310",
    "mnc": "120"
  }
}
```

Carrier or Mobile IP Data

## Company Data

**Available in**: [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api)

[Company Data](/data/ip-company) identifies the `name` of the organization behind the IP, the `type` of business, and its `domain` . We source this information from various publicly available datasets. 

```bash
curl https://ipinfo.io/8.8.8.8?token=$TOKEN
```

```json
{
  ...
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "business"
  }
}
```

> **Note**: The ability of IPinfo to tell the company depends on the size of the company and how it runs its network. 
>
> Suppose, WeWork NYC has rented its space to a startup. If someone from that startups visits your website, we might not be able to identify the company since it's small and uses its building's network. We will, however, be able to tell you that it's from WeWork.

Company Data

## Hosted Domains Data

**Available in**: [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api)

[Hosted Domains Data](/data/hosted-domains) returns the `total` count of domains being hosted on the IP address and a list of domains.

```bash
curl https://ipinfo.io/66.87.125.72?token=$TOKEN
```

```json
{
  ...
  "domains": {
    "ip": "8.8.8.8",
    "total": 11606,
    "domains": [
      "41.cn",
      "onionflix.cc",
      "newmax.info",
      "ftempurl.com",
      "itempurl.com"
    ]
  }
}
```

The number of domains returned per API request depends on the user's pricing tier:

- [IPinfo Business](/developers/business-api) tier: Up to 5 domains are returned per API request.
- [IPinfo Enterprise](/developers/enterprise-api) tier: Up to 1,000 domains are returned per API request.
- Hosted Domains database download: Up to 1,000 domains are available per IP address entry.

Both [IPinfo Business](/developers/business-api) and [IPinfo Enterprise](/developers/enterprise-api) users have access to a total of 1,000 domain names. However, on the [IPinfo Business](/developers/business-api) tier, users must go through paginated records to access more domain names.

The documentation and API parameters for the Hosted Domains endpoint are available in the [Hosted Domains API documentation section](/developers/hosted-domains).

Hosted Domains Data

## Abuse Contact Data

**Available in**: [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api)

[Abuse Contact Data](/data/ip-abuse-contact) is contact information (usually of the network administrator) which can be used to report IP addresses that are engaged in fraudulent/malicious activites. 

```bash
curl https://ipinfo.io/1.1.1.1?token=$TOKEN
```

```json
{
  ...
  "abuse": {
    "address": "PO Box 3646, South Brisbane, QLD 4101, Australia",
    "country": "AU",
    "email": "abuse@apnic.net",
    "name": "APNIC RESEARCH",
    "network": "1.1.1.0/24",
    "phone": "+61-7-3858-3188"
  }
}
```

Abuse Contact Data

## IP Type Data

**Available in**: [IPinfo Lite](/developers/lite-api), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), [IPinfo Business](/developers/business-api), and [IPinfo Enterprise](/developers/enterprise-api).

If the IP address is an [anycast](/faq/article/129-what-is-anycast-ip-address) or a [bogon](/faq/article/79-what-is-a-bogon-ip-address), the API returns a field indicating that.

**Bogon Address Information**

```bash
curl https://ipinfo.io/127.0.0.1?token=$TOKEN
```

```json
{
  "ip": "127.0.0.1",
  "bogon": true
}
```

**Anycast Information**

```bash
curl https://ipinfo.io/8.8.8.8?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  //...
}
```

IP Type Data

Data Types

## Bulk/Batch API

![IPinfo bulk image header](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_bulk_header_docs.png)

Our `/batch` API endpoint allows you to group up to 1,000 IPinfo API requests into a single request. This can significantly speed up the processing of bulk IP lookups, and it is also useful if you want to look up information across our different APIs.

**Batch URL endpoints**

The `/batch` API endpoint is available in both the legacy (`ipinfo.io`) and updated (`api.ipinfo.io`) API services.

For the updated API system the batch API endpoint is available at:

```
api.ipinfo.io/batch
```

The default API endpoint (`api.ipinfo.io/batch`) inherently supports the `/lookup` endpoint to query IP addresses, meaning that you do not have to prefix your IP address with `/lookup`. If you want to use `lite`, `resproxy`, or another API endpoint, please use the URL patterns method described in the next section.

**`api.ipinfo.io/batch/lite`** - Explicitly for the `lite` API endpoint. When using this API endpoint, you do not need to prefix `lite/` to IP addresses. Lite calls can be added to the legacy API `ipinfo.io/batch` requests as well. Please note that the `/lookup` API is dedicated to our paid tier API service. Therefore, if you are on the free tier and use the default bulk API endpoint (`api.ipinfo.io/batch`), you will encounter an error. For this reason, we recommend our free tier users use: `api.ipinfo.io/batch/lite`.

The Bulk or Batch API works identically with the legacy API endpoint (`ipinfo.io`) at the following API endpoint:

```
https://ipinfo.io/batch?token=$TOKEN
```

**Why URL patterns?**

We provide different types of IP data services through various API endpoints like `lite`, general IP information lookup (`lookup`), `resproxy`, etc. Additionally, users may not need the full API response payload; they might only need specific information from the API response, such as `/country`, `/city`, `asn`, etc. To support a diverse set of inputs and outputs, our batch API endpoint supports URL patterns.


```txt
115.227.65.62
lookup/71.181.13.80
lite/157.47.66.225
lookup/74.75.228.56/anonymous
lite/23.1.118.150/country_code
resproxy/164.53.56.110
```

**Usage**

![IPinfo bulk image usage example](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_bulk_demo_docs.gif)

The `/batch` endpoint accepts a list of IPs or URL patterns and returns a JSON object with the inputs as keys and the responses as values. The list of IPs can be provided as a newline-separated list of URLs, a space-separated list, or as a JSON array object. Below are examples of each approach, as well as the corresponding content-type headers required.


**JSON Array**

```bash
curl -XPOST --data '["lite/8.8.4.4", "lite/8.8.4.4/country", "8.8.4.4/anonymous", "1.1.1.1"]' \
"api.ipinfo.io/batch?token=$TOKEN"
```


```json
{
  "lite/8.8.4.4/country": "United States",
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  }
}
```


**Newline-separated list of IPs**

```bash
echo -e "lite/8.8.4.4\nlite/8.8.4.4/country\n8.8.4.4/anonymous\n1.1.1.1" | \
curl -X POST \
--data-binary @- "https://api.ipinfo.io/batch?token=$TOKEN"
```

```json
{
  "lite/8.8.4.4/country": "United States",
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  }
}
```

**Space-separated list of IPs**

```bash
curl --request POST --url https://api.ipinfo.io/batch?token=$TOKEN \
--header 'Content-Type: text/plain' \
--data 'lite/8.8.4.4 lite/8.8.4.4/country 8.8.4.4/anonymous 1.1.1.1'
```

```json
{
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "lite/8.8.4.4/country": "United States"
}
```

**List of IP addresses**

```bash
$ cat ips.txt
58.155.106.199
102.158.180.80
76.185.163.245
```

```
cat ips.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch?token=$TOKEN
```

```json
{
  "58.155.106.199": {
    "ip": "58.155.106.199",
    "geo": {
      "city": "Haidian",
      "region": "Beijing",
      "region_code": "BJ",
      "country": "China",
      "country_code": "CN",
      "continent": "Asia",
      "continent_code": "AS",
      "latitude": 39.99064,
      "longitude": 116.28868,
      "timezone": "Asia/Shanghai",
      "postal_code": "100000",
      "geoname_id": "1809104",
      "radius": 100,
      "last_changed": "2025-08-03"
    },
    "as": {
      "asn": "AS4538",
      "name": "China Education and Research Network Center",
      "domain": "cernet.edu.cn",
      "type": "education",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  },
  "102.158.180.80": {
    "ip": "102.158.180.80",
    "geo": {
      "city": "Tunis",
      "region": "Tunis Governorate",
      "region_code": "11",
      "country": "Tunisia",
      "country_code": "TN",
      "continent": "Africa",
      "continent_code": "AF",
      "latitude": 36.81897,
      "longitude": 10.16579,
      "timezone": "Africa/Tunis",
      "geoname_id": "2464470",
      "radius": 50
    },
    "as": {
      "asn": "AS37705",
      "name": "TOPNET",
      "domain": "topnet.tn",
      "type": "isp",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  },
  "76.185.163.245": {
    "ip": "76.185.163.245",
    "hostname": "syn-076-185-163-245.res.spectrum.com",
    "geo": {
      "city": "San Antonio",
      "region": "Texas",
      "region_code": "TX",
      "country": "United States",
      "country_code": "US",
      "continent": "North America",
      "continent_code": "NA",
      "latitude": 29.4275,
      "longitude": -98.4601,
      "timezone": "America/Chicago",
      "postal_code": "78202",
      "dma_code": "641",
      "geoname_id": "4726206",
      "radius": 10
    },
    "as": {
      "asn": "AS11427",
      "name": "Charter Communications Inc",
      "domain": "charter.com",
      "type": "isp",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  }
}
```

You can also use the Lite API-based bulk enrichment for all these applications.

```bash
cat ips.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch/lite?token=$TOKEN
```

```json
{
  "76.185.163.245": {
    "ip": "76.185.163.245",
    "asn": "AS11427",
    "as_name": "Charter Communications Inc",
    "as_domain": "charter.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "102.158.180.80": {
    "ip": "102.158.180.80",
    "asn": "AS37705",
    "as_name": "TOPNET",
    "as_domain": "topnet.tn",
    "country_code": "TN",
    "country": "Tunisia",
    "continent_code": "AF",
    "continent": "Africa"
  },
  "58.155.106.199": {
    "ip": "58.155.106.199",
    "asn": "AS4538",
    "as_name": "China Education and Research Network Center",
    "as_domain": "cernet.edu.cn",
    "country_code": "CN",
    "country": "China",
    "continent_code": "AS",
    "continent": "Asia"
  }
}
```


**URL Patterns**
```
$ cat ip_urls.txt
8.8.4.4/anonymous
1.1.1.1
lite/8.8.4.4
lite/8.8.4.4/country
```

```bash
cat ip_urls.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch?token=$TOKEN
```

```json
{
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "lite/8.8.4.4/country": "United States",
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  }
}
```

**Filter Option**

There is also an optional `filter` parameter, which if set will result in any URLs for which there's no response being removed from the response. This can be useful for things like finding hostnames that exist for a range of IPs:

```bash
ipinfo → ~ $ echo -e '8.8.8.8/hostname\n8.8.8.9/hostname' |  curl -XPOST --data-binary @- "api.ipinfo.io/batch?token=$TOKEN"
{
  "8.8.8.9/hostname": null,
  "8.8.8.8/hostname": "dns.google"
}
ipinfo → ~ $ echo -e '8.8.8.8/hostname\n8.8.8.9/hostname' |  curl -XPOST --data-binary @- "api.ipinfo.io/batch?token=$TOKEN&filter=1"
{
  "8.8.8.8/hostname": "dns.google"
}
```

Note that for the purposes of request volume tracking, the call to `/batch` itself isn't counted, but all of the URLs within the call are. So the example above counts as 2 requests, and a single call to `/batch` with 100 URLs would count as 100 requests.

The batch endpoint works across all of our APIs. So you can use it with our ASN, IP ranges, and hosted domains endpoints too.

Bulk/Batch API

## Command Line Interface (CLI)

To help with wrangling with our data on the command line, including doing batch requests trivially, you can try out our [IPinfo CLI](https://github.com/ipinfo/cli).

The CLI allows you to look up IP details in bulk or one-by-one, summarize the details of up to 1,000 IPs at a time, open a map of IP locations for any set of IPs, filter IPv4 & IPv6 addresses from any input, print out IP lists for any CIDR or IP range, and much more.

See [installation instructions](https://github.com/ipinfo/cli#installation) for details on how to get set up.

Command Line Interface (CLI)

Advanced Usage

# IP Database Download Developer Resource

## Downloading Database

You can download your subscribed IPinfo database in two different ways:

- Database download from your dashboard on the webpage
- Database download from using `curl` on your terminal

### Option 1: Database download from the account dashboard

You can visit the [Data Downloads](https://ipinfo.io/account/data-downloads) page to download your IPinfo database.

*Or,* you can go to:

1. your account [Dashboard](https://ipinfo.io/account/home)
2. select [Data Downloads](https://ipinfo.io/account/data-downloads)
3. and from there if you scroll down you will find your database that you can have subscribed to.

![Video showing steps to download a database file from the dashboard](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/data-download-dashboard.gif)

### Option 2: Database download using `cURL`

You can also download your IPinfo database using `cURL`. Please make sure you add the `-L` flag to your `cURL` command, which enables `cURL` to follow redirects.

```bash
curl -L https://ipinfo.io/data/location.csv.gz?token=$TOKEN -o location.csv.gz
```

![Image showing steps to download a database file with cURL](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/data-download-terminal.gif)

We use `gzip` to compress our database. After downloading the database, you can extract the content or decompress the database using `gzip`, `gunzip`, or any compression software of your choice.

Downloading Database

## Database Operations

### Getting specific country location

You can filter out the IP addresses from any specific country by using the `grep` command from your terminal. One thing to remember is that you must start and end the country code with commas, for example: `,US,`, `,IN,`, `,CA,` etc.

```bash
(head -1 location.csv;grep ",US," location.csv) > location_us.csv
```

If you use the solution above, your outputted CSV file will contain the header row as well.

![Image showing how to get specific country by location](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/getting-country-by-location.gif)

### Filtering the database with multiple countries/ASNs

Like filtering the database based on a single country or ASN, creating a sub-database containing multiple specific countries or ASNs is also possible. Let’s demonstrate that using multiple country filters. Get started by creating a text file(`countries.txt`) that contains your target countries in the following fashion:

```bash
,CA,
,FR,
,US,
,DE,
,UK,
```

As we will be using grep, your country code information must include the starting and trailing commas. Then using the -f option (stands for fixed-strings) run the following command.

```bash
(head -1 location.csv;grep -f countries.txt location.csv) > filtered_location.csv
```

This will create a filtered_locations.csv contains IP information of only the countries included in the countries.txt filter list.

![Image showing filtering the CSV database based on multiple country inputs](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/multiple-country-filter.gif)

### Convert IP addresses to IP ranges

### Convert IP addresses to IP ranges

If you want to convert the IP address range columns (`start_ip`, `end_ip`) to their CIDR equivalent, you can use our [IPinfo CLI app](https://github.com/ipinfo/cli). The `range2cidr` command of the IPinfo CLI will convert the two columns to their individual CIDR equivalent. For example:

| Input (Start IP - End IP) | Output (CIDR) |
| --- | --- |
| 91.232.89.0 — 91.232.89.255 | 91.232.89.0/24 |

![Image showing how to convert IP addresses to IP ranges](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/cidr2range.gif)

How to use the range2cidr command:

1. Install the [IPinfo CLI from GitHub](https://github.com/ipinfo/cli)
2. Unzip the downloaded IPinfo CSV database
3. Run then `range2cidr` command of the IPinfo CLI and save the output to a file
4. The outputted file would have the `start_ip` and `end_ip` columns converted to `cidr` column

```bash
ipinfo range2cidr location.csv > location_range.csv
```

### Exploring `MMDB` files using mmdbctl

Our open source [mmdbtctl](https://github.com/ipinfo/mmdbctl) makes exploration and management of MMDB files exceptionally easy.

Feel free to explore the documentation here: https://github.com/ipinfo/mmdbctl

| Code Snippet | Description |
| --- | --- |
| `mmdbctl read -f json-pretty 8.8.8.8 location.mmdb` | Lookup specific IP address (8.8.8.8) and output information as JSON from location.mmdb file |
| `mmdbctl read 8.8.8.0/31 location.mmdb` | Checking CIDR (8.8.8.0/31) data |
| `mmdbctl read 8.8.8.0-8.8.8.1 location.mmdb` | Getting IP range (8.8.8.0-8.8.8.1) data |
| `mmdbctl import --in data.csv --out data.mmdb` | Converting a CSV file (data.csv) to an MMDB file (data.mmdb) |
| `mmdbctl export data.mmdb data.csv` | Outputting CSV data (data.csv) from MMDB file (data.mmdb) |

![Image showing how to explore files using mmdbctl command](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/mmdbctl-demo.gif)

Database Operations

## MMDB reader libraries

If you want to read the MMDB database file using a programming language, you can use an MMDB reader library. The MMDB reader libraries supported by IPinfo are:

- [C](https://github.com/maxmind/libmaxminddb)
- [C#](https://github.com/maxmind/MaxMind-DB-Reader-dotnet)
- [Java](https://github.com/maxmind/MaxMind-DB-Reader-java)
- [Perl](https://github.com/maxmind/MaxMind-DB-Reader-perl)
- [PHP](https://github.com/maxmind/MaxMind-DB-Reader-php)
- [Python](https://github.com/maxmind/MaxMind-DB-Reader-python)
- [Ruby](https://github.com/maxmind/MaxMind-DB-Reader-ruby)
- [Nodejs](https://github.com/runk/node-maxmind) (v3.0.1+ and Node v22+ required for MMDBs larger than 4GiB)

Using the MMDB reader library, you can open the database and lookup an IP address. Using the mmdbctl tool, you can create your own custom MMDB databases as well. If you need any assistance with using these libraries, feel free to reach out to us.

MMDB reader libraries

## Downloads Rate limit

We restrict the number of times a database can be downloaded to ten (10) times per day. This restriction applies to each unique IP address for an individual device. However, we are happy to accommodate requests to increase download limits. [Learn more about rate limits on data downloads.](https://community.ipinfo.io/t/announcement-we-are-adding-rate-limits-to-data-downloads/358)

Downloads Rate limit

## Checksums 

Checksums are essential for ensuring data integrity and security. By comparing the calculated hash values with the provided checksums, users can verify that their downloaded files haven't been tampered with or corrupted during transit.

We offer checksums API endpoints for every data download, supporting all the file formats. Checksums API response includes three hash values: md5, sha1, and sha256. Aside from the API endpoint, you can view checksums from your [data downloads page](https://ipinfo.io/account/data-downloads) on your account dashboard.

```bash
curl https://ipinfo.io/data/free/country.csv.gz/checksums?token=$TOKEN
```

```json
{
  "checksums": {
    "md5": "75405cbe6ae89342dc4c58eede9f4bb2",
    "sha1": "8713da968c5bc0d89eba45ea349f75ac5569e21a",
    "sha256": "376f8148b250948bd236c00f4a00c95d2a22696ed3313141e9666af852f9bf1c"
  }
}
```

Checksums

## Cloud Data Delivery

We have the facilities to deliver our IP databases directly to your cloud storage buckets. As part of our IPinfo Enterprise plan, we support multiple cloud platforms and can deliver our IP database downloads directly to user's cloud storage bucket at regular intervals. The facilities we currently support are:

<table>
  <tbody>
    <tr>
      <td><strong>Cloud Storage Platform</strong></td>
      <td>
        <ul>
          <li>Google Cloud Storage</li>
          <li>AWS S3</li>
          <li>Azure Blob Storage</li>
        </ul>
      </td>
    </tr>
    <tr>
      <td><strong>Supported File Format</strong></td>
      <td>
        <ul>
          <li>CSV</li>
          <li>MMDB</li>
          <li>JSON</li>
          <li>Parquet</li>
        </ul>
      </td>
    </tr>
    <tr>
      <td><strong>Delivery Interval</strong></td>
      <td>
        <ul>
          <li>Daily</li>
          <li>Weekly</li>
          <li>Monthly</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

If you don't see the cloud platform or format you are looking for, reach out to our [data experts](https://ipinfo.io/contact) and we will get you set up.

Cloud Data Delivery

## Ecosystem Integrations

![IPinfo Data Consumption methods explained](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/data_consumption_compared.png)

Through our ecosystem integrations program you can access IPinfo's data download capabilities in a number of leading data, IT and security software platforms. Compared to the standard data download and data push mechanisms, our ecosystem integrations offer more enhanced user benefits including; 'on-platform' purchases, out of the box optimized user functions and often an easier path for integrating IPinfo's data across the broader enterprise technology landscape.

Some of the platforms we currently support are:

- Snowflake via [Snowflake Marketplace](https://ipinfo.io/snowflake)
- Google BigQuery via [Google Analytics Hub](https://console.cloud.google.com/bigquery/analytics-hub/exchanges;cameo=analyticshub;pageName=search;pageResource=?visibility=&queryText=ipinfo)
- [Graylog Cloud](https://go2docs.graylog.org/4-1/what_is_graylog/what_is_graylog_cloud.html)
- [Splunk](https://splunkbase.splunk.com/app/4070)

The data push mechanism, although it will deliver the data at your specified interval, it does not facilitate usage of the data across different marketplaces and does not include any out of the box optimized user functions.

If you are interested in exploring our ecosystem integrations, or have a requirement for an integration that we do not currently support, please contact alliances@ipinfo.io

Ecosystem Integrations

## Column/Field Types

Field types can differ depending on the download format:

- Parquet: fully typed, preserves booleans, numbers, and nulls.
- CSV: untyped, all values are strings; empty fields represents nulls.
- JSON: mostly untyped; numbers and booleans preserved when present, optional fields may be omitted.
- MMDB: typed for most IP database products; booleans and numbers preserved, optional fields may be absent.

Column/Field Types

## Database Guides

You can read some of our blog articles that showcase how to use our database:

- [Ingesting IPinfo geolocation data with PostgreSQL 13](https://ipinfo.io/blog/ingesting-ipinfo-geolocation-data-with-postgresql-13/)
- [Introducing a Simpler Way to get IP Address Data in Snowflake](https://ipinfo.io/blog/ip-address-data-in-snowflake/)
- [Data downloads vs API, or both?](https://ipinfo.io/blog/data-downloads-vs-api-or-both/)
- [Migrating from MaxMind to IPinfo](https://ipinfo.io/blog/migrating-from-maxmind-to-ipinfo/)
- [Our downloadable IP WHOIS data sets are live!](https://ipinfo.io/blog/our-downloadable-ip-whois-data-sets-are-live/)
- [How to choose the best file format for your IPinfo database?](https://ipinfo.io/blog/ipinfo-database-formats/)
- [IP data enrichment with IPinfo: 4 ways to add insights to your traffic/server logs](https://ipinfo.io/blog/ip-data-enrichment-in-4-ways/)

Want to share your experience as an IPinfo customer by writing an article? Email us at hello@ipinfo.io with an idea, we will get you set up.

Database Guides

# IP Database Downloads Filenames

Reference Table includes:

- Database download names
- Database file types: `CSV`, `JSON`, `MMDB`, and `Parquet` filename references
- The `CSV` and `JSON` files are compressed in `gzip` format


**Database download command using `curl`**

```bash
curl -L https://ipinfo.io/data/standard_location.json.gz?token=$TOKEN -o location.json.gz
```

**Using the sample datasets**

Each sample dataset is updated daily. It contains 100 rows of data in a systematic, randomized pattern. The data across all the different file formats for the same IP database download is identical. 

We recommend using these sample datasets for testing and integration development purposes. You can download the sample datasets without an IPinfo Access Token.

Database Filenames

Database Download

# IP Database Types Developer Resource

We provide a number of different database products covering different aspects and dimensions of IP information.

IPinfo Bundle Databases

## Standard Databases

Our paid databases include the following:

- [IP to Geolocation](/developers/ip-to-geolocation-database)
- [IP to Company](/developers/ip-to-company-database)
- [ASN Database](/developers/asn-database)
- [IP to Privacy Detection](/developers/privacy-detection-database)
- [IP to Mobile Carrier](/developers/ip-to-mobile-carrier-database)
- [Hosted Domains](/developers/hosted-domains-database)
- [Abuse Contact](/developers/abuse-contact-database)
- [IP WHOIS](/developers/ip-whois-database)
- [IP to Residential Proxy Database](/developers/ip-to-residential-proxy)

Standard Databases

## Extended Databases

IPinfo offers extended databases that covers IP geolocation precision data with accuracy radius and comprehensive IP privacy detection database with detection methodology.

- [IP to Geolocation Extended](/developers/ip-to-geolocation-extended)
- [IP to Privacy Detection Extended](/developers/privacy-detection-extended)

If you are interested in a customized database or historical data, please feel free to [reach out to us](/contact).

Extended Databases

# IPinfo Lite Database Developer Resource

The IPinfo Lite database is part of our [free IP data downloads offering](https://ipinfo.io/lite). The IPinfo Lite database is our ultimate free IP database combining both country and ASN information in a single database.

The IPinfo Lite Database includes:

- **Country-level geolocation data**: Country and continent information for IP addresses.
- **Basic ASN data**: Autonomous System Number (ASN), organization name, and domain name.

> You can access IPinfo Lite data through our unlimited requests API service: **[IPinfo Lite API](/developers/lite-api)**

IPinfo Lite

# IPinfo Core Database Developer Resource

IPinfo Core is a robust IP database that combines our location, ASN, network flags data in a single database.

IPinfo Core

# IPinfo Plus Database Developer Resource

IPinfo's Plus is an enterprise-grade IP database that combines our location, insights, and confidence with ASN, privacy, carrier, and network flags in a single database.

IPinfo Plus

# IP to Residential Proxy Database Developer Resource

The IP to Residential Proxy dataset provides information on IP addresses associated with residential, mobile, or datacenter proxy networks, allowing developers to identify proxy IPs, understand their type, and use usage-based signals to build risk or filtering logic. The IP to Residential Proxy Database identifies residential proxy IP addresses from over 100 services, including residential connections, carrier/phone, and data center proxies, and tracks both IPv4 and IPv6 IPs, providing details on the associated proxy service, last seen date, and percentage of days active over a certain time window period—all in a single, comprehensive database. This detection can identify SIM farm-based, compromised device, and smartphone SDK-based proxy IP addresses and more.

We currently recognize three types of residential proxies:
- Standard residential proxies: Residential proxy IP addresses
- Mobile/Carrier/Phone-based residential proxy IP addresses
- Datacenter-based residential proxy IP addresses

IP to Residential Proxy

# IP to Geolocation Database Developer Resource

[IP to Geolocation](/data/ip-geolocation) database provides geolocation information such as city, region/state, country, postal code, timezone, geographic coordinates (latitude & longitude) etc. identified from IP addresses.

IP to Geolocation

# IP Privacy Detection Database Developer Resource

[Privacy Detection or Anonymous IP database](https://ipinfo.io/data/proxy-vpn-detection) provides data on IP addresses that are associated with VPN, Tor, proxies, relays, and hosting services.

Privacy Detection

# IP to Company Database Developer Resource

The [IP to Company](/data/ip-company) database provides firmographic data such as the name of the company, company domain, company type, company country, and AS level data.

IP to Company

# ASN Database Developer Resource

The [ASN (Autonomous System Number) database](/data/ip-asn) provides AS-related data such as IP ranges within the AS, ASN, domain name of the AS, name of the AS, AS type (ISP, hosting, government, education, business), and country of the AS.

ASN Database

# IP to Mobile Carrier Database Developer Resource

IPinfo’s [IP to Mobile Carrier Database](/data/ip-carrier) provides insights such as IP addresses of mobile devices and their respective carrier name, mobile country code (MCC) and mobile country name (MNC).

IP to Mobile Carrier

# Hosted Domains Database Developer Resource

[Hosted Domains or Reverse IP database](/data/hosted-domains) shows the number and the list of domains hosted on an IP Address. The Hosted Domains database contains upto 1,000 domains per IP address entry.

Hosted Domains

# IP Abuse Contact Database Developer Resource

The [Abuse Contact database](https://ipinfo.io/data/ip-abuse-contact) provides abuse contact information of ISPs and hosting services for reporting malicious activities.

Abuse Contact

# IP WHOIS Developer Resource

Comprehensive, contextual, and updated [IP WHOIS database](/data/whois) allows you to look up an IP address and domain ownership, point of contact, organization, networks etc. The different types of WHOIS database we offer are:

- RWHOIS
- RIR WHOIS
- Additional Databases
  - WHOIS ASN (Autonomous System Numbers)
  - WHOIS MNT (Maintainer)
  - WHOIS NET (Network)
  - WHOIS ORG (Organization)
  - WHOIS POC (Point of Contact)

IP WHOIS

# IP to Geolocation Extended Database Developer Resource

IP to Geolocation Extended database offers comprehensive geolocation information such as city, region/state, country, postal code, timezone, and geographic coordinates (latitude & longitude). Additionally, it includes data accuracy measurement in the form of radius data.

IP to Geolocation Extended

# IP Privacy Detection Extended Database Developer Resource

Privacy Detection extended database reveals IP addresses linked to VPNs, Tor, proxies, relays, and hosting services. The database helps users to understand how we detect anonymous IP addresses so that they can use this information to build personalized cybersecurity policies.

Privacy Detection Extended

Database Types

# IP Data Integrations and Data Platforms

IPinfo has partnered with data marketplaces, workflow automation platforms, cybersecurity applications, and IT administration systems. Our goal is to provide an integrated environment that enables users to get and up running with IP data. You can check out our full list of integrations from our [integrations page](https://ipinfo.io/integrations).

The current list of IPinfo Platform integrations includes:

- [Snowflake Data Marketplace](/developers/snowflake)
- [Google BigQuery / Google Cloud Data Marketplace](/developers/gcp-integration)
- [Splunk](/developers/splunk)
- [Cribl](https://community.ipinfo.io/t/using-ipinfo-s-databases-in-cribl/5262)

We provide help in building your own platform-specific IPinfo integration using a [Bring Your Own License integration](/developers/byol-integration).

# IPinfo Splunk App Installation & Configuration

Download the IPinfo Splunk App from SplunkBase: https://splunkbase.splunk.com/app/4070

The IPinfo Splunk app integrates IPinfo's API and IP database products into the Splunk platform. This app adds the `ipinfo` command to Splunk, which utilizes IPinfo data through the API or IP database (MMDB) to look up IP information for specified IP addresses.

Full in-depth documentation is available at: https://github.com/ipinfo/splunk-docs

> Splunk setup can vary widely and be customized across different installations and ecosystems. So, we recommend investing time into understanding how the platform works with our app. 
> 
> This documentation is only recommended to be used as a guideline for how to use our Splunk App on the Splunk Enterprise installation. We encourage reaching out to our team to understand the best usage policies for our Splunk app.

Splunk

# IPinfo on Snowflake Marketplace

IPinfo is the premier IP data provider in the **[Snowflake Marketplace](https://app.snowflake.com/marketplace/providers/GZSTZ3VDMAT/IPinfo%20Inc.)**. To make the most of our data in Snowflake, we recommend that you go through this documentation.

![Snowflake header image](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/snowflake-header.gif)

Snowflake

# IPinfo on Google Cloud Platform

This document explores how to use our IP database within the Google Cloud Platform (GCP)'s data warehouse platform, BigQuery, delivered through Google Marketplace.

![GCP Analytics Hub to BQ](https://cdn.assets.ipinfo.io/static/images/docs/gcp/gcp_marketplace_to_bq.png)

Google Cloud / BigQuery

# IPinfo Integration Guide: Bring Your Own License (BYOL)

IPinfo provides access to its data services in four ways:
- [IPinfo API service](/developers/ipinfo-api)
- [IPinfo Data Downloads (DBDL)](/developers/database-types)
- [IPinfo Partner Platforms](/developers/integrations)
- [IPinfo Cloud Data Push](/developers/database-download#cloud-data-delivery)

When it comes to the API service and data downloads, access is controlled by an IPinfo Access Token (a 14-character alphanumeric token).
- Free accounts get access to [IPinfo Lite API](/developers/lite-api) + [IPinfo Lite database](/developers/ipinfo-lite-database).
- Paid accounts get access to the specific APIs or databases they’re subscribed to.

The idea behind **Bring Your Own License (BYOL)** is simple:
- If a platform wants to support IPinfo services, its users can sign up for IPinfo and provide their own access token.
- The integration platform acts as an intermediate layer, making API requests or database downloads on behalf of the user using their token.
- The platform itself never manages global IPinfo tokens each user brings their own.

> Recommended reading: [Data Downloads vs API, or Both?](/blog/data-downloads-vs-api)

Integration Guideline

Integrations

# Code Snippets

The Code Snippets page provides practical examples and commands for leveraging IPinfo's data, services, and libraries.

## General Code Snippets

**Extract only IPv4 addresses using the [IPinfo CLI](https://github.com/ipinfo/cli) from any text**

`-o` stands for only and `-4` is for IPv4.

```bash
cat ./access_logs | ipinfo grepip -o -4
```

**Create an [IPinfo summary report](/tools/summarize-ips) from IP addresseses**

The command will return a link where your summary report will be available.

```bash
cat iplist.txt | curl -XPOST --data-binary @- "ipinfo.io/tools/summarize-ips?cli=1"
```

**Create an [IPinfo map](/tools/map) from IP addresseses**

The command will provide a link for your IPinfo map.

```bash
cat iplist.txt | curl -XPOST --data-binary @- "https://ipinfo.io/tools/map?cli=1"
```

**Get a list of IPv4 prefixes owned by an [ASN](/developers/asn) using JQ**

```bash
curl "ipinfo.io/AS7922/json?token=$TOKEN" | jq -r '.prefixes[].netblock'
```

General Code Snippets

## Lite API Snippets

The IPinfo Lite API service provides information on the country and ASN of IP addresses. The IPinfo Lite API endpoint uses the `/lite/` API endpoint.

**Using the IPinfo Lite API service, get your/user/visitor IP address information:**

```bash
https://api.ipinfo.io/lite/me?token=$TOKEN
```

*Response:*

```json
{
  "ip": "82.163.118.147",
  "asn": "AS57276",
  "as_name": "Vorboss Limited",
  "as_domain": "optimity.co.uk",
  "country_code": "GB",
  "country": "United Kingdom",
  "continent_code": "EU",
  "continent": "Europe"
}
```

**Using the IPinfo Lite API service, get input IP address (IPv4) information:**

```bash
https://api.ipinfo.io/lite/3.153.114.80?token=$TOKEN
```

*Response:*

```json
{
  "ip": "3.153.114.80",
  "asn": "AS16509",
  "as_name": "Amazon.com, Inc.",
  "as_domain": "amazon.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

**Using the IPinfo Lite API service, get input IP address (IPv6) information:**

```bash
https://api.ipinfo.io/lite/2001:1900:2100:280e::f0?token=$TOKEN
```

*Response:*

```json
{
  "ip": "2001:1900:2100:280e::f0",
  "asn": "AS3356",
  "as_name": "Level 3 Parent, LLC",
  "as_domain": "lumen.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

**Using the IPinfo Lite API service, identify bogon IP address:**

```bash
https://api.ipinfo.io/lite/235.167.17.62?token=$TOKEN
```

*Response:*

```json
{
  "ip": "235.167.17.62",
  "bogon": true
}
```

**Using the IPinfo Lite API service to get information an unannounced/non-routed IP address:**

```bash
https://api.ipinfo.io/lite/64.201.151.1?token=$TOKEN
```

*Response:*

```json
{
  "ip": "64.201.151.1",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

**Using the IPinfo Lite API service, get your/user/visitor public IP address information:**

```bash
https://api.ipinfo.io/lite/me/ip?token=$TOKEN
```

*Response*:

```text
82.163.118.147
```

**Using the IPinfo Lite API service, get your/user/visitor IP address ASN information:**

```bash
https://api.ipinfo.io/lite/me/asn?token=$TOKEN
```

*Response*:

```text
AS57276
```

**Using the IPinfo Lite API service, get your/user/visitor IP address ASN Organization Name information:**

```bash
https://api.ipinfo.io/lite/me/as_name?token=$TOKEN
```
*Response*:

```text
Vorboss Limited
```

**Using the IPinfo Lite API service, get your/user/visitor IP address ASN Organization Domain Name information:**

```bash
https://api.ipinfo.io/lite/me/as_domain?token=$TOKEN
```

*Response*:

```text
optimity.co.uk    
``` 

**Using the IPinfo Lite API service, get your/user/visitor IP address 2 Letter Country Code information:**

```bash
https://api.ipinfo.io/lite/me/country_code?token=$TOKEN
```

*Response*:

```text
GB
```

**Using the IPinfo Lite API service, get your/user/visitor IP address country name:**

```bash
https://api.ipinfo.io/lite/me/country?token=$TOKEN
```

*Response*:

```text
United Kingdom
```

**Using the IPinfo Lite API service, get your/user/visitor IP address continent code information:**

```bash
https://api.ipinfo.io/lite/me/continent_code?token=$TOKEN
```

*Response*:

```text
EU
```

**Using the IPinfo Lite API service, get your/user/visitor IP address continent name information:**

```bash
https://api.ipinfo.io/lite/me/continent?token=$TOKEN
```

*Response*:

```text
Europe
```

**Using the IPinfo Lite API service, you can access the API from an IPv6 connection explicitly:**

```bash
https://v6.api.ipinfo.io/lite/2001:4930:98::1?token=$TOKEN
https://v6.api.ipinfo.io/lite/82.163.118.147?token=$TOKEN
https://v6.api.ipinfo.io/lite/me?token=$TOKEN
```


**Using the IPinfo Lite API service, you can access the API from an IPv4 connection explicitl:**

```bash
https://v4.api.ipinfo.io/lite/2001:4930:98::1?token=$TOKEN
https://v4.api.ipinfo.io/lite/82.163.118.147?token=$TOKEN
https://v4.api.ipinfo.io/lite/me?token=$TOKEN
```

Lite API Snippets

## Core API Snippets

The IPinfo Core API endpoint uses the `/lookup/` API endpoint.

**Using the IPinfo Core API service, get your/user/visitor IP address information:**

```bash
https://api.ipinfo.io/lookup/me?token=$TOKEN
```

*Response:*

```json
{
  "ip": "23.233.46.1",
  "hostname": "23-233-46-1.cpe.pppoe.ca",
  "geo": {
    "city": "Mississauga",
    "region": "Ontario",
    "region_code": "ON",
    "country": "Canada",
    "country_code": "CA",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 43.5789,
    "longitude": -79.6583,
    "timezone": "America/Toronto",
    "postal_code": "L5C"
  },
  "as": {
    "asn": "AS5645",
    "name": "TekSavvy Solutions, Inc.",
    "domain": "teksavvy.com",
    "type": "isp"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service, get input IP address (IPv4) information:**

```bash
https://api.ipinfo.io/lookup/106.54.79.181?token=$TOKEN
```

*Response:*

```json
{
  "ip": "106.54.79.181",
  "geo": {
    "city": "Shanghai",
    "region": "Shanghai",
    "region_code": "SH",
    "country": "China",
    "country_code": "CN",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 31.22222,
    "longitude": 121.45806,
    "timezone": "Asia/Shanghai",
    "postal_code": "200000"
  },
  "as": {
    "asn": "AS45090",
    "name": "Shenzhen Tencent Computer Systems Company Limited",
    "domain": "tencent.com",
    "type": "hosting"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service, get input IP address (IPv6) information:**

```bash
https://api.ipinfo.io/lookup/2001:1900:2100:280e::f0?token=$TOKEN
```

*Response:*

```json
{
  "ip": "2001:1900:2100:280e::f0",
  "geo": {
    "city": "San Francisco",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 37.77493,
    "longitude": -122.41942,
    "timezone": "America/Los_Angeles",
    "postal_code": "94102"
  },
  "as": {
    "asn": "AS3356",
    "name": "Level 3 Parent, LLC",
    "domain": "lumen.com",
    "type": "isp"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service, when the ip address does not have a region or region code:**

```bash
https://api.ipinfo.io/lookup/42.200.144.116?token=$TOKEN
```

*Response:*

```json
{
  "ip": "42.200.144.116",
  "hostname": "42-200-144-116.static.imsbiz.com",
  "geo": {
    "city": "Hong Kong",
    "country": "Hong Kong",
    "country_code": "HK",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 22.27832,
    "longitude": 114.17469,
    "timezone": "Asia/Hong_Kong",
    "postal_code": "999077"
  },
  "as": {
    "asn": "AS4760",
    "name": "HKT Limited",
    "domain": "netvigator.com",
    "type": "isp"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service, when the ip address does not have a postal or zip code:**

```bash
https://api.ipinfo.io/lookup/217.165.3.147?token=$TOKEN
```

*Response:*

```json
{
  "ip": "217.165.3.147",
  "hostname": "bba-217-165-3-147.alshamil.net.ae",
  "geo": {
    "city": "Musaffah",
    "region": "Abu Dhabi",
    "region_code": "AZ",
    "country": "United Arab Emirates",
    "country_code": "AE",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 24.35893,
    "longitude": 54.48267,
    "timezone": "Asia/Dubai"
  },
  "as": {
    "asn": "AS5384",
    "name": "Emirates Internet",
    "domain": "emirates.net.ae",
    "type": "isp"
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service, to get information of an unannounced/non-routed IP address:**

```bash
https://api.ipinfo.io/lookup/67.59.233.209?token=$TOKEN
```

*Response:*

```json
{
  "ip": "67.59.233.209",
  "hostname": "cbr104-te5-1-0.cmts.nrwlct.cv.net",
  "geo": {
    "city": "Norwalk",
    "region": "Connecticut",
    "region_code": "CT",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 41.1176,
    "longitude": -73.4079,
    "timezone": "America/New_York",
    "postal_code": "06851"
  },
  "as": {},
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service to get information of an anonymous IP address (VPN, proxy, relay or TOR):**

```bash
https://api.ipinfo.io/lookup/122.27.50.39?token=$TOKEN
```

*Response:*

```json
{
  "ip": "122.27.50.39",
  "hostname": "p2049039-ipxg00g01niho.hiroshima.ocn.ne.jp",
  "geo": {
    "city": "Hiroshima",
    "region": "Hiroshima",
    "region_code": "34",
    "country": "Japan",
    "country_code": "JP",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 34.4,
    "longitude": 132.45,
    "timezone": "Asia/Tokyo",
    "postal_code": "730-0011"
  },
  "as": {
    "asn": "AS4713",
    "name": "NTT Communications Corporation",
    "domain": "ntt.com",
    "type": "isp"
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service to get information of an anycast IP address:**

```bash
https://api.ipinfo.io/lookup/146.75.15.224?token=$TOKEN
```

*Response:*

```json
{
  "ip": "146.75.15.224",
  "geo": {
    "city": "Christchurch",
    "region": "Canterbury",
    "region_code": "CAN",
    "country": "New Zealand",
    "country_code": "NZ",
    "continent": "Oceania",
    "continent_code": "OC",
    "latitude": -43.53333,
    "longitude": 172.63333,
    "timezone": "Pacific/Auckland",
    "postal_code": "8011"
  },
  "as": {
    "asn": "AS54113",
    "name": "Fastly, Inc.",
    "domain": "fastly.com",
    "type": "hosting"
  },
  "is_anonymous": true,
  "is_anycast": true,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service to get information of a hosting or data center type IP address:**

```bash
https://api.ipinfo.io/lookup/107.182.226.232?token=$TOKEN
```

*Response:*

```json
{
  "ip": "107.182.226.232",
  "geo": {
    "city": "New York City",
    "region": "New York",
    "region_code": "NY",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 40.71427,
    "longitude": -74.00597,
    "timezone": "America/New_York",
    "postal_code": "10001"
  },
  "as": {
    "asn": "AS13213",
    "name": "UK-2 Limited",
    "domain": "ingenuitycloudservices.com",
    "type": "hosting"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Core API service to get information of a mobile or carrier type IP address:**

```bash
https://api.ipinfo.io/lookup/206.47.33.149?token=$TOKEN
```

*Response:*

```json
{
  "ip": "206.47.33.149",
  "geo": {
    "city": "Toronto",
    "region": "Ontario",
    "region_code": "ON",
    "country": "Canada",
    "country_code": "CA",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 43.6561,
    "longitude": -79.3406,
    "timezone": "America/Toronto",
    "postal_code": "M4M"
  },
  "as": {
    "asn": "AS577",
    "name": "Bell Canada",
    "domain": "bell.ca",
    "type": "isp"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": true,
  "is_satellite": false
}
```

**Using the IPinfo Core API service to get information of a satellite type IP address:**

```bash
https://api.ipinfo.io/lookup/65.181.4.152?token=$TOKEN
```

*Response:*

```json
{
  "ip": "65.181.4.152",
  "hostname": "customer.tkyojpn1.pop.starlinkisp.net",
  "geo": {
    "city": "Tokyo",
    "region": "Tokyo",
    "region_code": "13",
    "country": "Japan",
    "country_code": "JP",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 35.6895,
    "longitude": 139.69171,
    "timezone": "Asia/Tokyo",
    "postal_code": "101-8656"
  },
  "as": {
    "asn": "AS14593",
    "name": "Space Exploration Technologies Corporation",
    "domain": "spacex.com",
    "type": "isp"
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": true
}
```

**Using the IPinfo Core API service, get your/user/visitor IP address location information:**

```bash
https://api.ipinfo.io/lookup/me/geo?token=$TOKEN
```

*Response:*

```json
{
  "city": "Mississauga",
  "region": "Ontario",
  "region_code": "ON",
  "country": "Canada",
  "country_code": "CA",
  "continent": "North America",
  "continent_code": "NA",
  "latitude": 43.5789,
  "longitude": -79.6583,
  "timezone": "America/Toronto",
  "postal_code": "L5C"
}
```

**Using the IPinfo Core API service, get your/user/visitor IP address city information:**

```bash
https://api.ipinfo.io/lookup/me/geo/city?token=$TOKEN
```

*Response*:

```text
Mississauga
```

**Using the IPinfo Core API service, get your/user/visitor IP address region or state information:**

```bash
https://api.ipinfo.io/lookup/me/geo/region?token=$TOKEN
```

*Response*:

```text
Ontario
```

**Using the IPinfo Core API service, get your/user/visitor IP address region code information:**

```bash
https://api.ipinfo.io/lookup/me/geo/region_code?token=$TOKEN
```

*Response*:

```text
ON
```

**Using the IPinfo Core API service, get your/user/visitor IP address country name:**

```bash
https://api.ipinfo.io/lookup/me/geo/country?token=$TOKEN
```

*Response*:

```text
Canada
```

**Using the IPinfo Core API service, get your/user/visitor IP address two letter country code:**

```bash
https://api.ipinfo.io/lookup/me/geo/country_code?token=$TOKEN
```

*Response*:

```text
CA
```

**Using the IPinfo Core API service, get your/user/visitor IP address continent name:**

```bash
https://api.ipinfo.io/lookup/me/geo/continent?token=$TOKEN
```

*Response*:

```text
North America
```

**Using the IPinfo Core API service, get your/user/visitor IP address two leter continent code:**

```bash
https://api.ipinfo.io/lookup/me/geo/continent_code?token=$TOKEN
```

*Response*:

```text
NA
```

**Using the IPinfo Core API service, get your/user/visitor IP address latitude value of the geographic coordinate:**

```bash
https://api.ipinfo.io/lookup/me/geo/latitude?token=$TOKEN
```

*Response*:

```text
43.5789
```

**Using the IPinfo Core API service, get your/user/visitor IP address longitude value of the geographic coordinate:**

```bash
https://api.ipinfo.io/lookup/me/geo/longitude?token=$TOKEN
```

*Response*:

```text
-79.6583
```

**Using the IPinfo Core API service, get your/user/visitor IP address timezone information:**

```bash
https://api.ipinfo.io/lookup/me/geo/timezone?token=$TOKEN
```

*Response*:

```text
America/Toronto
```

**Using the IPinfo Core API service, get your/user/visitor IP address postal or zip code:**

```bash
https://api.ipinfo.io/lookup/me/geo/postal_code?token=$TOKEN
```

*Response*:

```text
L5C
```

**Using the IPinfo Core API service, get your/user/visitor IP address ASN information:**

```bash
https://api.ipinfo.io/lookup/me/as?token=$TOKEN
```

*Response:*

```json
{
  "asn": "AS5645",
  "name": "TekSavvy Solutions, Inc.",
  "domain": "teksavvy.com",
  "type": "isp"
}
```


**Using the IPinfo Core API service, get your/user/visitor IP address ASN value:**

```bash
https://api.ipinfo.io/lookup/me/as/asn?token=$TOKEN
```

*Response*:

```text
AS5645
```

**Using the IPinfo Core API service, get your/user/visitor IP address ASN organization name:**

```bash
https://api.ipinfo.io/lookup/me/as/name?token=$TOKEN
```

*Response*:

```text
TekSavvy Solutions, Inc.
```

**Using the IPinfo Core API service, get your/user/visitor IP address AS organization official domain:**

```bash
https://api.ipinfo.io/lookup/me/as/domain?token=$TOKEN
```

*Response*:

```text
teksavvy.com
```

**Using the IPinfo Core API service, get your/user/visitor IP address AS organization type (`government`, `education`, `business`, `isp` and `hosting`):**

```bash
https://api.ipinfo.io/lookup/me/as/type?token=$TOKEN
```

*Response*:

```text
isp
```


**Using the IPinfo Core API service, get your/user/visitor IP address anonymous status:**

```bash
https://api.ipinfo.io/lookup/me/is_anonymous?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Core API service, get your/user/visitor IP address anycast status:**

```bash
https://api.ipinfo.io/lookup/me/is_anycast?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Core API service, get your/user/visitor IP address hosting IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_hosting?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Core API service, get your/user/visitor IP address mobile / carrier IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_mobile?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Core API service, get your/user/visitor IP address satellite IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_satellite?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Core API service, you can access the API from an IPv6 connection explicitly:**

```bash
https://v6.api.ipinfo.io/lookup/2001:4930:98::1?token=$TOKEN
https://v6.api.ipinfo.io/lookup/82.163.118.147?token=$TOKEN
https://v6.api.ipinfo.io/lookup/me?token=$TOKEN
```


**Using the IPinfo Core API service, you can access the API from an IPv4 connection explicitly:**

```bash
https://v4.api.ipinfo.io/lookup/2001:4930:98::1?token=$TOKEN
https://v4.api.ipinfo.io/lookup/82.163.118.147?token=$TOKEN
https://v4.api.ipinfo.io/lookup/me?token=$TOKEN
```

Core API Snippets

## Plus API Snippets

The IPinfo Plus API endpoint uses the `/lookup/` API endpoint.

**Using the IPinfo Plus API service, get your/user/visitor IP address information:**

```bash
https://api.ipinfo.io/lookup/me?token=$TOKEN
```

*Response:*

```json
{
  "ip": "178.197.6.67",
  "geo": {
    "city": "Zürich",
    "region": "Zurich",
    "region_code": "ZH",
    "country": "Switzerland",
    "country_code": "CH",
    "continent": "Europe",
    "continent_code": "EU",
    "latitude": 47.3789,
    "longitude": 8.5204,
    "timezone": "Europe/Zurich",
    "postal_code": "8004",
    "geoname_id": "2657896",
    "radius": 200,
    "last_changed": "2024-03-24"
  },
  "as": {
    "asn": "AS3303",
    "name": "Swisscom (Switzerland) Ltd",
    "domain": "swisscom.ch",
    "type": "isp",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, get input IP address (IPv4) information:**

```bash
https://api.ipinfo.io/lookup/88.246.188.185?token=$TOKEN
```

*Response:*

```json
{
  "ip": "88.246.188.185",
  "hostname": "88.246.188.185.static.ttnet.com.tr",
  "geo": {
    "city": "Ankara",
    "region": "Ankara",
    "region_code": "06",
    "country": "Turkey",
    "country_code": "TR",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 39.91987,
    "longitude": 32.85427,
    "timezone": "Europe/Istanbul",
    "postal_code": "06420",
    "geoname_id": "323786",
    "radius": 50,
    "last_changed": "2025-08-03"
  },
  "as": {
    "asn": "AS47331",
    "name": "TTNet A.S.",
    "domain": "ttnet.com.tr",
    "type": "isp",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, get input IP address (IPv6) information:**

```bash
https://api.ipinfo.io/lookup/2c0f:4280:6040:1dbe:89e4:b86e:9e0a:cbb0?token=$TOKEN
```

*Response:*

```json
{
  "ip": "2c0f:4280:6040:1dbe:89e4:b86e:9e0a:cbb0",
  "geo": {
    "city": "Tunis",
    "region": "Tunis Governorate",
    "region_code": "11",
    "country": "Tunisia",
    "country_code": "TN",
    "continent": "Africa",
    "continent_code": "AF",
    "latitude": 36.81897,
    "longitude": 10.16579,
    "timezone": "Africa/Tunis",
    "geoname_id": "2464470",
    "radius": 20,
    "last_changed": "2025-09-21"
  },
  "as": {
    "asn": "AS37705",
    "name": "TOPNET",
    "domain": "topnet.tn",
    "type": "isp",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service for IP address without a region or region code:**

```bash
https://api.ipinfo.io/lookup/42.200.144.116?token=$TOKEN
```

*Response:*

```json
{
  "ip": "42.200.144.116",
  "hostname": "42-200-144-116.static.imsbiz.com",
  "geo": {
    "city": "Hong Kong",
    "country": "Hong Kong",
    "country_code": "HK",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 22.27832,
    "longitude": 114.17469,
    "timezone": "Asia/Hong_Kong",
    "postal_code": "999077",
    "geoname_id": "1819729",
    "radius": 20,
    "last_changed": "2025-09-21"
  },
  "as": {
    "asn": "AS4760",
    "name": "HKT Limited",
    "domain": "netvigator.com",
    "type": "isp"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, when the IP address does not have a postal or zip code:**

```bash
https://api.ipinfo.io/lookup/217.165.3.147?token=$TOKEN
```

*Response:*

```json
{
  "ip": "217.165.3.147",
  "hostname": "bba-217-165-3-147.alshamil.net.ae",
  "geo": {
    "city": "Musaffah",
    "region": "Abu Dhabi",
    "region_code": "AZ",
    "country": "United Arab Emirates",
    "country_code": "AE",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 24.35893,
    "longitude": 54.48267,
    "timezone": "Asia/Dubai",
    "geoname_id": "12042053",
    "radius": 10
  },
  "as": {
    "asn": "AS5384",
    "name": "Emirates Internet",
    "domain": "emirates.net.ae",
    "type": "isp",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": true
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service to get information of an unannounced/non-routed IP address:**

```bash
https://api.ipinfo.io/lookup/67.59.233.209?token=$TOKEN
```

*Response:*

```json
{
  "ip": "67.59.233.209",
  "hostname": "cbr104-te5-1-0.cmts.nrwlct.cv.net",
  "geo": {
    "city": "Norwalk",
    "region": "Connecticut",
    "region_code": "CT",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 41.1176,
    "longitude": -73.4079,
    "timezone": "America/New_York",
    "postal_code": "06851",
    "dma_code": "501",
    "geoname_id": "4839822",
    "radius": 50
  },
  "as": {},
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service to get information of an anonymous IP address (VPN, proxy, relay or TOR):**

```bash
https://api.ipinfo.io/lookup/162.120.206.244?token=$TOKEN
```

*Response:*

```json
{
  "ip": "162.120.206.244",
  "geo": {
    "city": "Saint-Avold",
    "region": "Grand Est",
    "region_code": "GES",
    "country": "France",
    "country_code": "FR",
    "continent": "Europe",
    "continent_code": "EU",
    "latitude": 49.10465,
    "longitude": 6.70402,
    "timezone": "Europe/Paris",
    "postal_code": "57500",
    "dma_code": "57",
    "geoname_id": "2981492",
    "radius": 10
  },
  "as": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "name": "Google One VPN",
    "is_proxy": false,
    "is_relay": true,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, information of an anycast IP address:**

```bash
https://api.ipinfo.io/lookup/146.75.15.224?token=$TOKEN
```

*Response:*

```json
{
  "ip": "146.75.15.224",
  "geo": {
    "city": "Christchurch",
    "region": "Canterbury",
    "region_code": "CAN",
    "country": "New Zealand",
    "country_code": "NZ",
    "continent": "Oceania",
    "continent_code": "OC",
    "latitude": -43.53333,
    "longitude": 172.63333,
    "timezone": "Pacific/Auckland",
    "postal_code": "8011",
    "geoname_id": "2192362",
    "radius": 10,
    "last_changed": "2024-04-14"
  },
  "as": {
    "asn": "AS54113",
    "name": "Fastly, Inc.",
    "domain": "fastly.com",
    "type": "hosting",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "name": "Fastly",
    "is_proxy": false,
    "is_relay": true,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": true,
  "is_anycast": true,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, information of a hosting or data center type IP address:**

```bash
https://api.ipinfo.io/lookup/107.182.226.232?token=$TOKEN
```

*Response:*

```json
{
  "ip": "107.182.226.232",
  "geo": {
    "city": "New York City",
    "region": "New York",
    "region_code": "NY",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 40.71427,
    "longitude": -74.00597,
    "timezone": "America/New_York",
    "postal_code": "10001",
    "dma_code": "501",
    "geoname_id": "5128581",
    "radius": 10,
    "last_changed": "2024-05-19"
  },
  "as": {
    "asn": "AS13213",
    "name": "UK-2 Limited",
    "domain": "ingenuitycloudservices.com",
    "type": "hosting",
    "last_changed": "2025-09-28"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, information of mobile or carrier type IP address:**

```bash
https://api.ipinfo.io/lookup/206.47.33.149?token=$TOKEN
```

*Response:*

```json
{
  "ip": "206.47.33.149",
  "geo": {
    "city": "Toronto",
    "region": "Ontario",
    "region_code": "ON",
    "country": "Canada",
    "country_code": "CA",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 43.6561,
    "longitude": -79.3406,
    "timezone": "America/Toronto",
    "postal_code": "M4M",
    "geoname_id": "6167865",
    "radius": 50,
    "last_changed": "2025-09-21"
  },
  "as": {
    "asn": "AS577",
    "name": "Bell Canada",
    "domain": "bell.ca",
    "type": "isp"
  },
  "mobile": {
    "name": "Bell Mobility",
    "mcc": "302",
    "mnc": "610"
  },
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": true,
  "is_satellite": false
}
```

**Using the IPinfo Plus API service, information of satellite type IP address:**

```bash
https://api.ipinfo.io/lookup/65.181.4.152?token=$TOKEN
```

*Response:*

```json
{
  "ip": "65.181.4.152",
  "hostname": "customer.tkyojpn1.pop.starlinkisp.net",
  "geo": {
    "city": "Tokyo",
    "region": "Tokyo",
    "region_code": "13",
    "country": "Japan",
    "country_code": "JP",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 35.6895,
    "longitude": 139.69171,
    "timezone": "Asia/Tokyo",
    "postal_code": "101-8656",
    "geoname_id": "1850147",
    "radius": 10,
    "last_changed": "2022-10-09"
  },
  "as": {
    "asn": "AS14593",
    "name": "Space Exploration Technologies Corporation",
    "domain": "spacex.com",
    "type": "isp"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": true
}
```

**Using the IPinfo Plus API service, get your/user/visitor IP address location information:**

```bash
https://api.ipinfo.io/lookup/me/geo?token=$TOKEN
```

*Response:*

```json
{
  "city": "Rome",
  "region": "Lazio",
  "region_code": "62",
  "country": "Italy",
  "country_code": "IT",
  "continent": "Europe",
  "continent_code": "EU",
  "latitude": 41.89193,
  "longitude": 12.51133,
  "timezone": "Europe/Rome",
  "postal_code": "00118",
  "geoname_id": "3169070",
  "radius": 1000,
  "last_changed": "2025-07-13"
}
```

**Using the IPinfo Plus API service, get your/user/visitor IP address city information:**

```bash
https://api.ipinfo.io/lookup/me/geo/city?token=$TOKEN
```

*Response*:

```text
Rome
```

**Using the IPinfo Plus API service, get your/user/visitor IP address region or state information:**

```bash
https://api.ipinfo.io/lookup/me/geo/region?token=$TOKEN
```

*Response*:

```text
Lazio
```

**Using the IPinfo Plus API service, get your/user/visitor IP address region code information:**

```bash
https://api.ipinfo.io/lookup/me/geo/region_code?token=$TOKEN
```

*Response*:

```text
62
```

**Using the IPinfo Plus API service, get your/user/visitor IP address country name:**

```bash
https://api.ipinfo.io/lookup/me/geo/country?token=$TOKEN
```

*Response*:

```text
Italy
```

**Using the IPinfo Plus API service, get your/user/visitor IP address two letter country code:**

```bash
https://api.ipinfo.io/lookup/me/geo/country_code?token=$TOKEN
```

*Response*:

```text
IT
```

**Using the IPinfo Plus API service, get your/user/visitor IP address continent name:**

```bash
https://api.ipinfo.io/lookup/me/geo/continent?token=$TOKEN
```

*Response*:

```text
Europe
```

**Using the IPinfo Plus API service, get your/user/visitor IP address two leter continent code:**

```bash
https://api.ipinfo.io/lookup/me/geo/continent_code?token=$TOKEN
```

*Response*:

```text
EU
```

**Using the IPinfo Plus API service, get your/user/visitor IP address latitude value of the geographic coordinate:**

```bash
https://api.ipinfo.io/lookup/me/geo/latitude?token=$TOKEN
```

*Response*:

```text
41.89193
```

**Using the IPinfo Plus API service, get your/user/visitor IP address longitude value of the geographic coordinate:**

```bash
https://api.ipinfo.io/lookup/me/geo/longitude?token=$TOKEN
```

*Response*:

```text
12.51133
```

**Using the IPinfo Plus API service, get your/user/visitor IP address timezone information:**

```bash
https://api.ipinfo.io/lookup/me/geo/timezone?token=$TOKEN
```

*Response*:

```text
Europe/Rome
```

**Using the IPinfo Plus API service, get your/user/visitor IP address postal or zip code:**

```bash
https://api.ipinfo.io/lookup/me/geo/postal_code?token=$TOKEN
```

*Response*:

```text
00118
```

**Using the IPinfo Plus API service, get your/user/visitor IP address DMA code:**

```bash
https://api.ipinfo.io/lookup/me/geo/dma_code?token=$TOKEN
```

*Response*:

```text
534
```

**Using the IPinfo Plus API service, get your/user/visitor IP address geoname.org ID:**

```bash
https://api.ipinfo.io/lookup/me/geo/geoname_id?token=$TOKEN
```

*Response*:

```text
3169070
```

**Using the IPinfo Plus API service, get the accuracy radius in Kilometer for the geographic coordinates the user's or visitor's IP address:**

```bash
https://api.ipinfo.io/lookup/me/geo/radius?token=$TOKEN
```

*Response*:

```text
1000
```

**Using the IPinfo Plus API service, get the last date when the visitor's IP address geolocation information changed:**

```bash
https://api.ipinfo.io/lookup/me/geo/last_changed?token=$TOKEN
```

*Response*:

```text
2025-07-13
```

**Using the IPinfo Plus API service, get your/user/visitor IP address ASN information:**

```bash
https://api.ipinfo.io/lookup/me/as?token=$TOKEN
```

*Response:*

```json
{
  "asn": "AS3269",
  "name": "Telecom Italia S.p.A.",
  "domain": "telecomitalia.com",
  "type": "isp",
  "last_changed": "2025-09-28"
}
```


**Using the IPinfo Plus API service, get your/user/visitor IP address ASN value:**

```bash
https://api.ipinfo.io/lookup/me/as/asn?token=$TOKEN
```

*Response*:

```text
AS3269
```

**Using the IPinfo Plus API service, get your/user/visitor IP address ASN organization name:**

```bash
https://api.ipinfo.io/lookup/me/as/name?token=$TOKEN
```

*Response*:

```text
Telecom Italia S.p.A.
```

**Using the IPinfo Plus API service, get your/user/visitor IP address AS organization official domain:**

```bash
https://api.ipinfo.io/lookup/me/as/domain?token=$TOKEN
```

*Response*:

```text
telecomitalia.com
```

**Using the IPinfo Plus API service, get your/user/visitor IP address AS organization type (`government`, `education`, `business`, `isp` and `hosting`):**

```bash
https://api.ipinfo.io/lookup/me/as/type?token=$TOKEN
```

*Response*:

```text
isp
```

**Using the IPinfo Plus API service, get your/user/visitor IP address ASN information last change date:**

```bash
https://api.ipinfo.io/lookup/me/as/last_changed/type?token=$TOKEN
```

*Response*:

```text
2025-09-28
```


**Using the IPinfo Plus API service, get your/user/visitor IP address anonymous status:**

```bash
https://api.ipinfo.io/lookup/me/is_anonymous?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address anycast status:**

```bash
https://api.ipinfo.io/lookup/me/is_anycast?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address hosting IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_hosting?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address mobile / carrier IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_mobile?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address satellite IP status:**

```bash
https://api.ipinfo.io/lookup/me/is_satellite?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address mobile/carrier information:**

```bash
https://api.ipinfo.io/lookup/me/mobile?token=$TOKEN
```

*Response*:

```json
{
  "name": "TIM",
  "mcc": "222",
  "mnc": "01"
}
```

**Using the IPinfo Plus API service, get your/user/visitor IP address mobile/carrier name:**

```bash
https://api.ipinfo.io/lookup/me/mobile/name?token=$TOKEN
```

*Response*:

```text
TIM
```

**Using the IPinfo Plus API service, get your/user/visitor IP address Mobile Carrier Code (MCC):**

```bash
https://api.ipinfo.io/lookup/me/mobile/mcc?token=$TOKEN
```

*Response*:

```text
222
```

**Using the IPinfo Plus API service, get your/user/visitor IP address Mobile Network Code (MNC):**

```bash
https://api.ipinfo.io/lookup/me/mobile/mnc?token=$TOKEN
```

*Response*:

```text
01
```

**Using the IPinfo Plus API service, get your/user/visitor IP address anonymity/privacy information:**

```bash
https://api.ipinfo.io/lookup/me/anonymous?token=$TOKEN
```

*Response*:

```json
{
  "name": "ExpressVPN",
  "is_proxy": false,
  "is_relay": false,
  "is_tor": false,
  "is_vpn": true
}
```

**Using the IPinfo Plus API service, get your/user/visitor IP address proxy status:**

```bash
https://api.ipinfo.io/lookup/me/anonymous/is_proxy?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address relay status:**

```bash
https://api.ipinfo.io/lookup/me/anonymous/is_relay?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address TOR status:**

```bash
https://api.ipinfo.io/lookup/me/anonymous/is_tor?token=$TOKEN
```

*Response*:

```text
false
```

**Using the IPinfo Plus API service, get your/user/visitor IP address VPN status:**

```bash
https://api.ipinfo.io/lookup/me/anonymous/is_vpn?token=$TOKEN
```

*Response*:

```text
true
```

**Using the IPinfo Plus API service, get your/user/visitor IP address privacy service name:**

```bash
https://api.ipinfo.io/lookup/me/anonymous/name?token=$TOKEN
```

*Response*:

```text
ExpressVPN
```

**Using the IPinfo Plus API service, you can access the API from an IPv6 connection explicitly:**

```bash
https://v6.api.ipinfo.io/lookup/2001:4930:98::1?token=$TOKEN
https://v6.api.ipinfo.io/lookup/82.163.118.147?token=$TOKEN
https://v6.api.ipinfo.io/lookup/me?token=$TOKEN
```


**Using the IPinfo Plus API service, you can access the API from an IPv4 connection explicitly:**

```bash
https://v4.api.ipinfo.io/lookup/2001:4930:98::1?token=$TOKEN
https://v4.api.ipinfo.io/lookup/82.163.118.147?token=$TOKEN
https://v4.api.ipinfo.io/lookup/me?token=$TOKEN
```

Plus API Snippets

Code Snippets

# IPinfo OpenAPI Specification

This page provides the [official IPinfo OpenAPI (Swagger)](/developers/openapi.yaml) specification, commonly searched for under terms such as: IPinfo Swagger, IPinfo API YAML, openapi.yaml, swagger.yaml, or Swagger/OpenAPI spec.

This specification is intended for integration demos, client generation, and any tooling that consumes standard OpenAPI/Swagger definitions.

You can access the raw OpenAPI YAML file here: [https://ipinfo.io/developers/openapi.yaml](/developers/openapi.yaml)

OpenAPI Spec

# Official API Supported Libraries Developer Resource

## For programming languages

We maintain a number of official client libraries for popular programming languages. Using one of our libraries is the easiest way to get setup with our API. They also add some additional functionality, such as including the full country name, and built in support for caching.

| Language | Source code                                       | Package                                                                  |
| -------- | ------------------------------------------------- | ------------------------------------------------------------------------ |
| PHP      | [ipinfo/php](https://github.com/ipinfo/php)       | [Packagist](https://packagist.org/packages/ipinfo/ipinfo)                |
| Python   | [ipinfo/python](https://github.com/ipinfo/python) | [PyPi](https://pypi.org/project/ipinfo/)                                 |
| Perl     | [ipinfo/perl](https://github.com/ipinfo/perl)     | [CPAN](https://metacpan.org/pod/Geo::IPinfo)                             |
| Java     | [ipinfo/java](https://github.com/ipinfo/java)     | [Maven Central](https://mvnrepository.com/artifact/io.ipinfo/ipinfo-api) |
| C#       | [ipinfo/csharp](https://github.com/ipinfo/csharp) | [Nuget](https://www.nuget.org/packages/IpInfo/)                          |
| Ruby     | [ipinfo/ruby](https://github.com/ipinfo/ruby)     | [Ruby Gems](https://rubygems.org/gems/IPinfo)                            |
| Go       | [ipinfo/go](https://github.com/ipinfo/go)         | [GitHub](https://github.com/ipinfo/go)                                   |
| Rust     | [ipinfo/rust](https://github.com/ipinfo/rust)     | [crates.io](https://crates.io/crates/ipinfo)                             |
| NodeJS   | [ipinfo/node](https://github.com/ipinfo/node)     | [NPM package](https://www.npmjs.com/package/node-ipinfo)                 |
| Erlang   | [ipinfo/erlang](https://github.com/ipinfo/erlang) | [hex.pm](https://hex.pm/packages/ipinfo)                                 |
| Swift    | [ipinfo/swift](https://github.com/ipinfo/swift)   | [GitHub](https://github.com/ipinfo/swift)                                |

For programming languages

## For frameworks

We also maintain some official libraries for popular web frameworks. These offer framework specific middleware so that with just a few lines of code you can get IPinfo data for every visitor to your site. They also include functionality like user agent filtering, so you can reduce your request volumes by not looking up details for bots and spiders.

| Framework | Source code                                              | Package                                                                     |
| --------- | -------------------------------------------------------- | --------------------------------------------------------------------------- |
| Express   | [ipinfo/express](https://github.com/ipinfo/node-express) | [NPM package](https://www.npmjs.com/package/ipinfo-express)                 |
| Django    | [ipinfo/django](https://github.com/ipinfo/django)        | [PyPi](https://pypi.org/project/ipinfo-django/)                             |
| Laravel   | [ipinfo/laravel](https://github.com/ipinfo/laravel)      | [Packagist](https://packagist.org/packages/ipinfo/ipinfolaravel)            |
| Rails     | [ipinfo/rails](https://github.com/ipinfo/rails)          | [Ruby Gems](https://rubygems.org/gems/ipinfo-rails)                         |
| Spring    | [ipinfo/spring](https://github.com/ipinfo/spring)        | [Maven Central](https://mvnrepository.com/artifact/io.ipinfo/ipinfo-spring) |

For frameworks

## Command Line Interface (CLI)

If you prefer to use our APIs from the command line, we have you covered: try out our [IPinfo CLI](https://github.com/ipinfo/cli).

The CLI allows you to look up IP details in bulk or one-by-one, summarize the details of up to 1000 IPs at a time, open a map of IP locations for any set of IPs, filter IPv4 & IPv6 addresses from any input, print out IP lists for any CIDR or IP range, and much more.

See [installation instructions](https://github.com/ipinfo/cli#installation) for details on how to get setup.

## Third party libraries

There are a large number of unofficial IPinfo libraries written by third parties. While these are not maintained by us and haven't been tested by us they can be a great way to get started quickly with IPinfo if you're using a language or framework that we don't have an official library for. [Search GitHub for IPinfo libraries](https://github.com/search?q=ipinfo.io).