
# IP Database Types Developer Resource

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

## 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)

## IPinfo Bundle Databases

We offer a number of different IP databases that combine various IP metadata into a single database.

- [IPinfo Lite](/developers/ipinfo-lite-database) (Country, ASN)
- [IPinfo Core](/developers/ipinfo-core-database) (Location, ASN, Network Flags)
- [IPinfo Plus](/developers/ipinfo-plus-database) (Comprehensive IP Database)

## Free Databases

IPinfo's free data download is the [IPinfo Lite](/developers/ipinfo-lite-database) data downloads, which include country and ASN information. The database is licensed under CC-BY-SA 4.0.

## 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).


# 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/User**

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's API services provide a mix of geolocation, ASN, privacy, carrier detection, and confidence metrics across different tiers of API services.

Currently, we have the following API services available directly for customers.

- [IPinfo Lite](/developers/lite-api)
- [IPinfo Core](/developers/core-api)
- [IPinfo Plus](/developers/plus-api)
- [IPinfo Business](/developers/responses#ipinfo-business)
- [IPinfo Enterprise](/developers/responses#ipinfo-enterprise)

# 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/core) 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 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.

## Geolocation Data

**Available in**: IPinfo Lite (Limited), IPinfo Core, Standard, IPinfo Business, and IPinfo Enterprise

Our IP geolocation data is available with full access on our paid plans, and a country level geolocation version is offered in the [IPinfo Lite API](/developers/ipinfo-lite-api). The full IP geolocation response provides the country, region/state, city, postal/zip code, geographic coordinates and timezone of the queried or current IP address. The IPinfo Lite API geolocation response includes the country name, country code, continent name, and continent code.

**IPinfo Core, Standard, IPinfo Business and IPinfo Enterprise Plans**

```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"
}
```

**IPinfo Lite API**

```bash
curl https://api.ipinfo.io/lite/8.8.8.8?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"
}
```

Geolocation Data

## ASN Data

**Available in**: IPinfo Lite (Limited), IPinfo Core, Standard, IPinfo Business, and IPinfo Enterprise

[ASN Data](/products/asn-api) returns information related to the ASN (Autonomous System Number) of the current or queried IP. In the paid plans, the API returns ASN, ASN organization name, ASN organization type (hosting, business, ISP, education, and government), ASN organization domain, and the prefix route for the IP address. In the IPinfo Lite (free) plan, the API returns the ASN, ASN organization name, and ASN domain name.

**IPinfo Core, Standard, IPinfo Business and IPinfo Enterprise Plans**

```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, you also get access to the standalone ASN API 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).

**IPinfo 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",
  ...
}
```

ASN Data

## Privacy Data

**Available in**: IPinfo Core (Limited), Standard, IPinfo Business, and IPinfo Enterprise

[Privacy Data](/products/proxy-vpn-detection-api) or anonymous IP data returns various methods used to mask a user's true IP address, including VPN detection, 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 standard, IPinfo Business, and IPinfo Enterprise plans. A limited response is available on the IPinfo Core plan, showing if the IP address is an anonymous IP and whether it belongs to a hosting or data center service."

**Standard, IPinfo Business and IPinfo Enterprise Plans**

```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"
  }
  ...
}
```

**IPinfo Core Plan**

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

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

Privacy Data

## Carrier Data

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

[Carrier Data](/products/ip-carrier-api) returns mobile carrier-related information for the IP address. The full IP to Carrier response is available across the IPinfo Business and IPinfo Enterprise plans, which include the mobile carrier's name, its country code (MCC), and network code (MNC). In limited capability, IPinfo Core also contains IP to carrier information, flagging carrier IP addresses.

**Standard, IPinfo Business and IPinfo Enterprise Plans**

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

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

**IPinfo Core**

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

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

Carrier Data

## Company Data

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

[Company Data](/products/ip-company-api) 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, and IPinfo Enterprise

[Hosted Domains Data](/products/reverse-ip-api) 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 tier: Up to 5 domains are returned per API request.
- IPinfo Enterprise 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 and IPinfo Enterprise users have access to a total of 1,000 domain names. However, on the IPinfo Business 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, and IPinfo Enterprise

[Abuse Contact Data](/products/ip-abuse-contact-api) 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, IPinfo Core, Standard, IPinfo Business, and IPinfo Enterprise.

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",
  ...
}
```

In the IPinfo Lite API tier, anycast IPs are identified with the `is_anycast` response flagged persistently with a `true` or `false` response.

```
  ...
  "is_anycast": false,
  ...
```

IP Type Data

Data Types

# Other IP APIs Developer Resource

Besides providing information about IP Addresses, IPInfo also offers APIs that can be used to get:

- [Detailed information about ASNs](/developers/asn)
- [IP ranges owned by a company](/developers/ranges)
- [Domains hosted on an IP address](/developers/hosted-domains)
- [WHOIS data](/developers/whois)
- [Residential Proxy Detection API](/developers/resproxy-api)

# Documentation for IPinfo Residential Proxy Detection API

The IPinfo Residential Proxy Detection API provides detailed insights into IP addresses associated with residential proxies, 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)**

IPinfo Residential Proxy 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/products/ip-company-database), 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",
    ...
  ]
}
```

Ranges API

# Hosted Domains API Developer Resource

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

Our Hosted Domains, or [Reverse IP API](/products/reverse-ip-api) 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

Other APIs

# IP API Responses Developer Resource

Below is a description of all the information you'll get for the various plans we offer:

## IPinfo Business

Our IPinfo Business plan includes access to multiple data fields besides ASN and geolocation, including `privacy`, `abuse`, `company`, `carrier` and limited `domains` hosted on the IP. 

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

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "postal": "94043",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "hosting"
  },
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": ""
  },
  "abuse": {
    "address": "US, CA, Mountain View, 1600 Amphitheatre Parkway, 94043",
    "country": "US",
    "email": "network-abuse@google.com",
    "name": "Abuse",
    "network": "8.8.8.0/24",
    "phone": "+1-650-253-0000"
  },
  "domains": {
    "ip": "8.8.8.8",
    "total": 9791,
    "domains": [
      "musicool.cn",
      "kagou.vip",
      "nmgk2.com",
      "91xiazai.com",
      "bits-hyderabad.ac.in"
    ]
  }
}
```

You can also query domains data separately. Check [how you can find domains hosted on IP](/developers/hosted-domains) using [Hosted Domains API](/products/reverse-ip-api).

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

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

IPinfo Business

## 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](/products/reverse-ip-api) 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

Responses

## Bulk/Batch API

![IPinfo bulk image header](https://website-cdn.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.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

## Getting Started

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.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.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.

## 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.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.ipinfo.io/static/images/docs/getting-started-with-database/multiple-country-filter.gif)

**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.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.ipinfo.io/static/images/docs/getting-started-with-database/mmdbctl-demo.gif)


**Using 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.

**Rate limit for data downloads**

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)

**Checksums API endpoint**

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"
  }
}
```

Database Operations

## 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.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

## 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 Filename Reference Developer Resource

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`. Example:

```bash
curl -L https://ipinfo.io/data/standard_location.json.gz?token=$TOKEN -o location.json.gz
```

Database Filename Reference

Database Download

# IP Database Types Developer Resource

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

## 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

## IPinfo Bundle Databases

We offer a number of different IP databases that combine various IP metadata into a single database.

- [IPinfo Lite](/developers/ipinfo-lite-database) (Country, ASN)
- [IPinfo Core](/developers/ipinfo-core-database) (Location, ASN, Network Flags)
- [IPinfo Plus](/developers/ipinfo-plus-database) (Comprehensive IP Database)

IPinfo Bundle Databases

## Free Databases

IPinfo's free data download is the [IPinfo Lite](/developers/ipinfo-lite-database) data downloads, which include country and ASN information. The database is licensed under CC-BY-SA 4.0.

Free 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 Geolocation Database Developer Resource

[IP to Geolocation](/products/ip-geolocation-database) 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/products/anonymous-ip-database) 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](/products/ip-company-database) 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](/products/asn-database) 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](/products/mobile-ip-database) 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](/products/hosted-domains-database) 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 to Residential Proxy Database Developer Resource

The IP to Residential Proxy Database identifies residential proxy IP addresses from nearly 100 services, including mobile/carrier network proxies. It tracks both IPv4 and IPv6 IPs, providing details on the associated proxy service, last seen date, and percentage of days active over a 90-day period—all in a single, comprehensive database.

IP to Residential Proxy

# IP Abuse Contact Database Developer Resource

The [Abuse Contact database](https://ipinfo.io/products/ip-abuse-contact-database) 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](/products/ip-whois-data-download) 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

## Snowflake

IPinfo is the premier data provider on the Snowflake Marketplace. To enable our users to use our service on the Snowflake Marketplace, we have prepared technical documentation that enables users to get started in no time:

- [IPinfo Snowflake Documentation](https://ipinfo.io/developers/snowflake_integration)

Besides the technical documentation, we highly recommend users check out our [articles on IPinfo's Snowflake integration](https://ipinfo.io/blog/tag/snowflake/). If you have any queries in regard to our Snowflake partnership, reach out to us at [snowflake@ipinfo.io](mailto:snowflake@ipinfo.io)

Snowflake

# 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.ipinfo.io/static/images/docs/snowflake/snowflake-header.gif)

# 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.ipinfo.io/static/images/docs/gcp/gcp_marketplace_to_bq.png)

Google Cloud / BigQuery

Integrations

# Code Snippets

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

**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 ./acesss_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'
```

Code Snippets

# 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).