
# Custom API

The Custom APIs are offered as a customized API service, available only to enterprise customers, where you select specific API services and a request quota tailored to your needs. Rather than a fixed package like our self-serve tiers, it lets you build a custom API response by combining the services you require.

<table border="1" cellspacing="0" cellpadding="5">
  <thead>
    <tr>
      <th>Custom API</th>
      <th>Self-Serve Alternative</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td rowspan="2"><a href="/developers/geolocation-api">IP Geolocation</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes full geolocation information</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full geolocation plus additional accuracy metadata</td>
    </tr>
    <tr>
      <td rowspan="2"><a href="/developers/ip-asn-api-data">IP to ASN</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes full ASN information</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full ASN plus last change information</td>
    </tr>
    <tr>
      <td rowspan="3"><a href="/developers/privacy-standard-api">Privacy Detection API</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes privacy/anonymous IP data via IP connection type data</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a></td>
      <td>Includes full privacy data</td>
    </tr>
    <tr>
      <td><a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full privacy data and residential proxy data</td>
    </tr>
    <tr>
      <td><a href="/developers/residential-proxy-api">IP to Residential Proxy</a></td>
      <td><a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full privacy data and residential proxy data</td>
    </tr>
    <tr>
      <td rowspan="2"><a href="/developers/ip-carrier-api-data">Carrier Detection (Mobile IP Data) API</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes carrier flag via IP connection type field</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full carrier information</td>
    </tr>
  </tbody>
</table>

The following services are available as a custom API only through an enterprise contract, with no self-serve alternative:

- [ASN API](/developers/asn)
- [IP to Company](/developers/company-api)
- [Extended Privacy Detection API](/developers/privacy-extended-api)
- [Abuse Contact API](/developers/abuse-contact-api)
- [IP WHOIS](/developers/whois)
- [IP Ranges](/developers/ranges)
- [Hosted Domains API](/developers/hosted-domains)

> **Note:** The Custom API does not automatically include all of the services listed above. You choose only the services and request quota that match your needs.

IP Geolocation API

IPinfo Places API

# IPinfo Developer Resource

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/oMwqfJZ8Lfc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

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.

![IPinfo Quickstat](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_quickstart.png)

## Authentication

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_api_auth.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

Your [API token](/dashboard/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.

You can find your IPinfo API access token on your [dashboard](/dashboard/token).

![IPinfo Access Token](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_api_access_token.png)

<Tabs>
  <Tab title="IPinfo Lite">

[IPinfo Lite](/developers/lite-api) is our free tier API service available to all users. The API returns country and ASN information without any API request quota restrictions.

> IPinfo Lite uses the **`api.ipinfo.io`** API URL and **`/lite`** endpoint.


```bash
# With token query parameter
$ curl https://api.ipinfo.io/lite/me?token=$TOKEN
$ curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lite/me
$ curl -u $TOKEN: https://api.ipinfo.io/lite/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lite/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lite/8.8.8.8
```

<details>

<summary>API Response</summary>

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

</details>

  </Tab>

  <Tab title="IPinfo Core">

[IPinfo Core](/developers/core-api) is our entry-level premium API service that combines granular geolocation, ASN data, and network flags.

> IPinfo Core uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "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"
  },
  "as": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting"
  },
  "is_anonymous": false,
  "is_anycast": true,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>

  </Tab>

  <Tab title="IPinfo Lookup">

[IPinfo Plus](/developers/plus-api) API service provides granular geolocation information with accuracy radius, mobile carrier details, anonymous IP address data, and network flags.

> IPinfo Plus uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "geo": {
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 38.00881,
    "longitude": -122.11746,
    "timezone": "America/Los_Angeles",
    "postal_code": "94043",
    "dma_code": "807",
    "geoname_id": "5375478",
    "radius": 500
  },
  "as": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting",
    "last_changed": "2021-05-01"
  },
  "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
}
```

</details>

  </Tab>

  <Tab title="IPinfo Max">

[IPinfo Max](/developers/max-api) API service provides granular geolocation information with accuracy radius, mobile carrier details, anonymous IP address data, residential proxy detection, and network flags.

> IPinfo Max uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "1.0.66.247",
  "hostname": "247.66.0.1.megaegg.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",
    "geoname_id": "1862415",
    "radius": 1000,
    "last_changed": "2023-07-02"
  },
  "as": {
    "asn": "AS18144",
    "name": "Enecom,Inc.",
    "domain": "enecom.co.jp",
    "type": "business",
    "last_changed": "2021-05-01"
  },
  "mobile": {},
  "anonymous": {
    "name": "anyIP",
    "last_seen": "2026-03-30",
    "percent_days_seen": 25,
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false,
    "is_res_proxy": true
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>
  </Tab>

  <Tab title="Custom API">

The [Custom API](/developers/custom-api), offered only to enterprise customers, is a highly customizable service that may include all different types of IP metadata. This schema can vary for users customized to their needs.

```bash
# With token query parameter
$ curl https://ipinfo.io?token=$TOKEN
$ curl https://ipinfo.io/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://ipinfo.io
$ curl -u $TOKEN: https://ipinfo.io/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://ipinfo.io
$ curl -H "Authorization: Bearer $TOKEN" https://ipinfo.io/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "82.102.30.130",
  "city": "Los Angeles",
  "region": "California",
  "country": "US",
  "loc": "34.0522,-118.2437",
  "org": "AS9009 M247 Europe SRL",
  "postal": "90012",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS9009",
    "name": "M247 Europe SRL",
    "domain": "m247global.com",
    "route": "82.102.30.0/24",
    "type": "hosting"
  },
  "company": {
    "name": "VENUS BUSINESS COMMUNICATIONS LIMITED",
    "domain": "m247.com",
    "type": "hosting"
  },
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": "PrivateVPN",
    "confidence": 3,
    "coverage": 1,
    "census": false,
    "census_ports": "",
    "device_activity": false,
    "inferred": false,
    "vpn_config": false,
    "whois": false,
    "first_seen": "2025-10-14",
    "last_seen": "2026-01-11"
  },
  "abuse": {
    "address": "Turing House, Archway 5, Manchester, M15 5RL, UNITED KINGDOM",
    "country": "GB",
    "email": "network.infrastructure@m247.com",
    "name": "M247 UK Ltd Network Infrastructure",
    "network": "82.102.30.128/25",
    "phone": ""
  },
  "domains": {
    "ip": "82.102.30.130",
    "total": 53,
    "domains": [
      "hdchina.org",
      "ymjump.com",
      "musicool.cn",
      "viewpointcloud.com",
      "itempurl.com"
    ]
  },
  "resproxy": {
    "last_seen": "2026-01-05",
    "percent_days_seen": 13,
    "service": "ProxyScrape"
  },
  "is_anycast": false,
  "is_mobile": false,
  "is_anonymous": true,
  "is_satellite": false,
  "is_hosting": true
}
```

</details>
  </Tab>
</Tabs>

Authentication

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

### URL Structure

The API follows a consistent URL structure with the following components:

| Component | Description | Examples |
|-----------|-------------|----------|
| **Base URL** | The base domain for all API requests | `api.ipinfo.io` |
| **Endpoint** | The API version endpoint | `lite` (IPinfo Lite)<br>`lookup` (Core/Plus) |
| **IP Address** | The IP to lookup (optional, defaults to requester's IP) | `me` (your IP)<br>`8.8.8.8` (IPv4)<br>`2001:4860:4860::8888` (IPv6) |
| **Field Filter** | Optional filter to return only specific fields (returned as plaintext) | `/country`<br>`/asn`<br>`/country_code`<br>`/is_proxy` |
| **Token** | Your authentication token (query parameter) | `?token=$TOKEN` |

**Example URLs:**

```
https://api.ipinfo.io/lite/me?token=$TOKEN
https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN
https://api.ipinfo.io/lite/2001:4860:4860::8888/country?token=$TOKEN
```

<Tabs>
  <Tab title="IPinfo Lite">

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

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

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

  </Tab>
  <Tab title="IPinfo Lookup">

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

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

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

  </Tab>
  <Tab title="IPinfo Legacy">

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

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

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

  </Tab>
</Tabs>

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

IP Address Parameter

## Rate Limits

[IPinfo Lite](/developers/lite-api) offers unlimited access to our API. [Paid plans](/pricing) include a monthly request limit with configurable alerts to help you stay in control. If you exceed your plan's limit, you'll receive a `429` HTTP status code. With metered billing enabled, usage continues uninterrupted via overages.

What is not limited:

- No daily or hourly caps. You can use your full monthly quota in any pattern, including consuming it all within a single hour.
- No concurrent request limits. There is no enforced cap on parallel requests. Our infrastructure routinely serves customers running hundreds of thousands of - requests per second.
- No per-second throttling on paid plans. The monthly request count is the only volume constraint.

Rate Limits

## Filtering Responses

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/api_filtering_response.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

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.

<Tabs>
  <Tab title="IPinfo Lite">

```bash
# Get the ASN
$ curl https://api.ipinfo.io/lite/8.8.8.8/asn?token=$TOKEN
AS15169

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

  </Tab>
  <Tab title="IPinfo Lookup">

```bash

Filtering Responses

## Get all the Geolocation data as a JSON object
$ curl https://api.ipinfo.io/lookup/8.8.8.8/geo?token=$TOKEN

Get all the Geolocation data as a JSON object

## Get the city name as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/geo/city?token=$TOKEN

Get the city name as a string

## Get the ASN data as a JSON object
$ curl https://api.ipinfo.io/lookup/8.8.8.8/as?token=$TOKEN

Get the ASN data as a JSON object

## Get the ASN as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/as/asn?token=$TOKEN

Get the ASN as a string

## Get network flag data as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/is_anonymous?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8/is_satellite?token=$TOKEN
```

  </Tab>
  <Tab title="Custom API">

```bash
# Get the organization field
$ curl https://ipinfo.io/8.8.8.8/org?token=$TOKEN
AS15169 Google Inc.

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

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

  </Tab>
</Tabs>

Dual Stack API Service

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

<Tabs>
  <Tab title="Fetch API (Promise)">

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

  </Tab>
  <Tab title="Fetch API (Async/Await)">

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

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

  </Tab>
  <Tab title="JSONP">

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

  </Tab>
</Tabs>

JSONP/CORS Requests

## Database Downloads

IPinfo's data is also available as downloadable databases (CSV, MMDB, JSON, and Parquet formats) that you can host offline and query yourself. Browse the available databases on the [Database Types](/developers/database-types) page, or head straight to [Database Download](/developers/database-download) for setup instructions.

Database Downloads

Getting Started

IPinfo Lite API

IPinfo Core API

IPinfo Plus API

IPinfo Max API

# IPinfo Lite API

**Available for**: Every IPinfo user

The [IPinfo Lite API](/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 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 Core API

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

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

> IPinfo Core data is also available as a downloadable database for enterprise customers. Database downloads are not included in self-serve API plans and require a separate enterprise subscription. Learn more: **[IPinfo Core IP Data Downloads](/developers/ipinfo-core-database)**

# IPinfo Plus API

The [IPinfo Plus](/plus) API is our most popular API service that provides detailed IP address data, including geolocation, ASN information, mobile carrier details, and privacy-related flags.

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

> IPinfo Plus data is also available as a downloadable database for enterprise customers. Database downloads are not included in self-serve API plans and require a separate enterprise subscription. Learn more: **[IPinfo Plus IP Data Downloads](/developers/ipinfo-plus-database)**

# IPinfo Max API

The [IPinfo Max](/pricing) API is our most comprehensive API service, building on all IPinfo Plus features with full anonymization coverage including residential proxy behavioral signals.

- **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, relay services.
- **Residential Proxy detection**: Residential proxy information as well as time-bound behavioral activity and frequency metadata.
- **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

# IPinfo Places API

The **[IPinfo Places](/data/places)** API identifies the real-world location associated with an IP address at the building level. It matches IP addresses observed on venue Wi-Fi networks to verified physical places such as hotels, airports, museums, stadiums, transit stations, and 70+ other categories.

- **Place name**: The name of the venue or building associated with the IP address. This information can be used to identify the brand of the business as well.
- **Location category**: One of 70+ standardized location tags (e.g., `hotel`, `museum`, `airport`).
- **Network SSID**: The Wi-Fi network name observed at the venue.
- **Coordinates**: The building-level latitude and longitude of the matched place.

> **IPinfo Places is currently in public beta.** Access is available via API. Additional fields and data (including brand, building dimensions, polygon boundaries, BSSIDs, and last-seen date) are available for select use cases.
> 
> [Request access](/data/places#form) to learn more.

IPinfo APIs

Privacy Standard API

Residential Proxy API

Privacy Extended API

IP to Company API

Abuse Contact API

ASN API

IP Ranges API

Hosted Domains API

IP Whois API

IPinfo Business API

# Custom API

The Custom APIs are offered as a customized API service, available only to enterprise customers, where you select specific API services and a request quota tailored to your needs. Rather than a fixed package like our self-serve tiers, it lets you build a custom API response by combining the services you require.

<table border="1" cellspacing="0" cellpadding="5">
  <thead>
    <tr>
      <th>Custom API</th>
      <th>Self-Serve Alternative</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td rowspan="2"><a href="/developers/geolocation-api">IP Geolocation</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes full geolocation information</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full geolocation plus additional accuracy metadata</td>
    </tr>
    <tr>
      <td rowspan="2"><a href="/developers/ip-asn-api-data">IP to ASN</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes full ASN information</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full ASN plus last change information</td>
    </tr>
    <tr>
      <td rowspan="3"><a href="/developers/privacy-standard-api">Privacy Detection API</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes privacy/anonymous IP data via IP connection type data</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a></td>
      <td>Includes full privacy data</td>
    </tr>
    <tr>
      <td><a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full privacy data and residential proxy data</td>
    </tr>
    <tr>
      <td><a href="/developers/residential-proxy-api">IP to Residential Proxy</a></td>
      <td><a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full privacy data and residential proxy data</td>
    </tr>
    <tr>
      <td rowspan="2"><a href="/developers/ip-carrier-api-data">Carrier Detection (Mobile IP Data) API</a></td>
      <td><a href="/developers/core-api">IPinfo Core</a></td>
      <td>Includes carrier flag via IP connection type field</td>
    </tr>
    <tr>
      <td><a href="/developers/plus-api">IPinfo Plus</a> / <a href="/developers/max-api">IPinfo Max</a></td>
      <td>Includes full carrier information</td>
    </tr>
  </tbody>
</table>

The following services are available as a custom API only through an enterprise contract, with no self-serve alternative:

- [ASN API](/developers/asn)
- [IP to Company](/developers/company-api)
- [Extended Privacy Detection API](/developers/privacy-extended-api)
- [Abuse Contact API](/developers/abuse-contact-api)
- [IP WHOIS](/developers/whois)
- [IP Ranges](/developers/ranges)
- [Hosted Domains API](/developers/hosted-domains)

> **Note:** The Custom API does not automatically include all of the services listed above. You choose only the services and request quota that match your needs.

# IP Geolocation API

Offered as a customized API service, available only to enterprise customers.

The IPinfo IP Geolocation API returns the city, region, country, coordinates, timezone, and postal code associated with an IP address. It's offered as a [Custom API](/developers/custom-api), where customers select the specific API services and request quota that match their needs.

Geolocation data is available through self-serve options directly as well.

| Self-Serve Tier | Coverage |
| --- | --- |
| [IPinfo Lite](/developers/lite-api) (Free) | Country and continent only |
| [IPinfo Core](/developers/core-api) | Full geolocation information |
| [IPinfo Plus](/developers/plus-api) / [IPinfo Max](/developers/max-api) | Full geolocation plus accuracy metadata |

> If you're not an existing Custom API user, we recommend starting with one of our self-serve API tiers above — no enterprise contract required.

# Privacy Detection API (Standard)

Offered as a customized API service, available only to enterprise customers.

The IPinfo IP to Privacy Detection (Standard) API provides detection of anonymous IP addresses, identifying whether an IP is associated with a VPN, proxy, Tor network, relay service, or hosting provider. IPinfo uses multi-modal detection methods to detect anonymous IP addresses, which includes internet measurement, IP address behavior and characteristics, internet records metadata, etc.

Privacy detection data is available through self-serve options directly as well.

| Self-Serve Tier | Coverage |
| --- | --- |
| [IPinfo Core](/developers/core-api) (limited) | Privacy/anonymous IP data via IP connection type flags |
| [IPinfo Plus](/developers/plus-api) | Full privacy detection data |
| [IPinfo Max](/developers/max-api) | Full privacy detection data plus residential proxy data |

> If you're not an existing Custom API user, we recommend starting with one of our self-serve API tiers above — no enterprise contract required.

# Residential Proxy Detection API

Offered as a customized API service, available only to enterprise customers.

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.

Residential proxy data is available through self-serve options directly.

| Self-Serve Tier | Coverage |
| --- | --- |
| [IPinfo Max](/developers/max-api) | Full privacy data plus residential proxy detection |

> If you're not an existing Custom API user, we recommend starting with one of our self-serve API tiers above — no enterprise contract required.

# Privacy Detection API (Extended)

Offered as a customized API service, available only to enterprise customers.

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

# IP to Company API

Offered as a customized API service, available only to enterprise customers.

The IPinfo IP to Company API identifies the organization behind an IP address, including the company name, business type, and domain. This information is sourced from various publicly available datasets. It's offered as a [Custom API](/developers/custom-api), where customers select the specific API services and request quota that match their needs.

# Abuse Contact API

Offered as a customized API service, available only to enterprise customers.

The IPinfo Abuse Contact API returns contact information, typically of the network administrator, that can be used to report IP addresses engaged in fraudulent or malicious activity. It's offered as a [Custom API](/developers/custom-api), where customers select the specific API services and request quota that match their needs. You can access IPinfo Abuse Contact data as a downloadable dataset as well: **[Abuse Contact Database Downloads](/developers/abuse-contact-database)**

# ASN API

Offered as a customized API service, available only to enterprise customers.

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

# IP Ranges

Offered as a customized API service, available only to enterprise customers.

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.

# Hosted Domains API

Offered as a customized API service, available only to enterprise customers.

Our Hosted Domains, or [Reverse IP API](/data/hosted-domains) returns a list of all of the domains hosted on the provided IP address. Custom API 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"
    ...
  ]
}
```

# IP Whois API

Offered as a customized API service, available only to enterprise customers.

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.

# IPinfo Business

> The Business API is no longer available for new customers. Existing customers retain full access.

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.

Custom APIs

IP Geolocation API Data

Privacy Detection API Data

IP ASN API Data

Mobile IP API Data

# IP Data Types

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), [IPinfo Plus](/developers/plus-api) and [IPinfo Max](/developers/max-api).
> - `https://ipinfo.io` is used for the [Custom API](/developers/custom-api).

## Geolocation Data

IPinfo's IP geolocation data is available through multiple API services, from free to enterprise. Each tier offers varying levels of granularity from country and continent up to city, postal code, coordinates, and accuracy metadata.

Learn more: [IPinfo API - IP Geolocation Data](/developers/ip-geolocation-api-data)

Geolocation Data

## Privacy Detection Data

IPinfo's privacy detection data identifies whether an IP address is associated with anonymization services such as VPNs, proxies, Tor, or relays. It is available across Core, Plus, and as a Custom API, with each tier offering increasing levels of detail.

Learn about them here: [IPinfo API - IP Privacy Detection Data](/developers/ip-privacy-detection-api-data)

Privacy Detection Data

## ASN Data

IPinfo's ASN data provides information about the Autonomous System associated with an IP address, including the ASN number, organization name, domain, and type. It is available across Lite, Core, Plus, and as a Custom API, with each tier offering additional fields such as route/prefix information and record change history.

Learn about them here: [IPinfo API - IP ASN Data](/developers/ip-asn-api-data)

ASN Data

## Carrier Data

IPinfo's carrier data identifies the mobile network associated with an IP address, including the carrier name and its Mobile Country Code (MCC) and Mobile Network Code (MNC). It is available across Core, Plus, and as a Custom API, where Core returns a basic mobile flag and the higher tiers return the full carrier details.

Learn about them here: [IPinfo API - Carrier or Mobile IP Data](/developers/ip-carrier-api-data)

Carrier Data

## Company Data

**Available in**: [Custom API](/developers/custom-api), offered only to enterprise customers

[Company Data](/data/ip-company) identifies the organization behind an IP address, including its name, business type, and domain. This information is sourced from various publicly available datasets.

Learn more: [IPinfo API - IP to Company API](/developers/company-api)

Company Data

## Hosted Domains Data

**Available in**: [Custom API](/developers/custom-api), offered only to enterprise customers

[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:

- [Custom API](/developers/custom-api): 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.

[Custom API](/developers/custom-api) users have access to a total of 1,000 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**: [Custom API](/developers/custom-api), offered only to enterprise customers

[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 or malicious activities.

Learn more: [IPinfo API - Abuse Contact API](/developers/abuse-contact-api)

Abuse Contact Data

## IP Type Data

**Available in**: [IPinfo Lite](/developers/lite-api), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), [IPinfo Max](/developers/max-api), and as a [Custom API](/developers/custom-api).

If the IP address is an [anycast](https://support.ipinfo.io/hc/en-us/articles/30792495607442-What-is-Anycast-IP-address) or a [bogon](https://support.ipinfo.io/hc/en-us/articles/30792495147794-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

# IP Geolocation API Data

**Available in**: IPinfo Lite (Limited), IPinfo Core, IPinfo Plus, [IPinfo Max](/developers/max-api), and as a [Custom API](/developers/custom-api)

- Country-level geolocation data is offered in the IPinfo Lite API.
- The full IP geolocation response is available across all our paid plans.
- The IPinfo Plus and IPinfo Max API service comes with accuracy radius and geolocation stability fields.

# IP to Privacy Detection API Data

**Available in**: IPinfo Core (Limited), IPinfo Plus, IPinfo Max, IPinfo IP to Privacy Detection API (Custom API), and IPinfo IP to Privacy Detection Extended API (Custom API)

- The IPinfo Core API returns only limited information via IP flags for detecting non-residential IP addresses.
- The IPinfo Plus and IPinfo Max API return a summary anonymous IP detection response via the `/anonymous` endpoint, while through the Custom API it is returned via the `/privacy` endpoint.
- The IPinfo IP to Privacy Detection Extended API includes additional confidence, coverage, and signal fields.

# IP ASN API Data

**Available in**: [IPinfo Lite](/developers/lite-api) (Limited), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), [IPinfo Max](/developers/max-api), and as a [Custom API](/developers/custom-api)

- In the [IPinfo Lite](/developers/lite-api) plan, the API will return the ASN, AS Organization name, and AS Domain name.
- In the [IPinfo Core](/developers/core-api) API tier, you will have access to the ASN, AS Organization name, AS Domain name, and AS type.
- In the [IPinfo Plus](/developers/plus-api) and [IPinfo Max](/developers/max-api) API tiers, you will have access to the ASN, AS organization name, AS domain name, and AS type. You will also have access to the date the ASN record was last changed.

Through the [Custom API](/developers/custom-api), you can access to the dedicated [ASN API service](/developers/asn) for ASN Information.

# Carrier or Mobile IP API Data

**Available in**: [IPinfo Core](/developers/core-api) (Partial), [IPinfo Plus](/developers/plus-api), [IPinfo Max](/developers/max-api), and as a [Custom API](/developers/custom-api)

[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 [IPinfo Plus](/developers/plus-api), [IPinfo Max](/developers/max-api), and the [Custom API](/developers/custom-api), which include the mobile carrier's name, its Mobile Country Code (MCC), and Mobile Network Code (MNC).

Data Types

# Batch Enrichment API

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

The `/batch` API endpoint lets you group up to 1,000 IPinfo API requests into a single HTTP request. This significantly speeds up bulk IP processing and also makes it easy to combine lookups across different APIs in one call.

## Endpoints

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

There are three batch endpoints:

| Endpoint | Default lookup | Tier | Use case |
|---|---|---|---|
| `https://api.ipinfo.io/batch` | `/lookup` (Core/Plus/Max) | Paid | Standard batch lookups on the updated API schema |
| `https://api.ipinfo.io/batch/lite` | `/lite` | Free and paid | Country, continent, and ASN data for free-tier users |
| `https://api.ipinfo.io/batch/legacy` (or `https://ipinfo.io/batch`) | Legacy `ipinfo.io` | Paid | Legacy response shape and Privacy Extended data |

The default endpoint (`api.ipinfo.io/batch`) inherently uses `/lookup`, so you do not need to prefix IPs with `lookup/`. To use `lite`, `resproxy`, or other endpoints in the same request, use the URL patterns method described in the next section.

Free-tier users should use `api.ipinfo.io/batch/lite`, since `/lookup` is a paid-tier endpoint and will return an error on free tokens.

The legacy batch service is available at `https://api.ipinfo.io/batch/legacy` and at `https://ipinfo.io/batch`. Use it if you need the legacy response shape or Privacy Extended fields under `privacy`.

Endpoints

## URL Patterns

IPinfo offers several IP data services through different API endpoints, including `lite`, general lookup, `resproxy`, and others. You may also want only part of a response, such as `/country`, `/city`, or `/asn`. To support this, the batch endpoint accepts 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
domains/1.1.1.1
ranges/nytimes.com
AS52188
```

URL Patterns

## Request Formats

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

The `/batch` endpoint takes a list of IPs or URL patterns and returns a JSON object where each input is a key and the corresponding lookup is the value. You can submit inputs as a JSON array, a newline-separated list, or a space-separated list. Examples of each format follow, along with the correct `Content-Type` header.

### 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"]' \
"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"
  },
  "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

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

### Space-Separated List

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

### IP List from File

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

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

Request Formats

## Endpoints and Input Parameters

### Full Reference

**`https://api.ipinfo.io/batch/lite`**

The `/lite` endpoint is available to all users, both free and paid tier.

- `<ip>`
- `<ip>/ip`
- `<ip>/country`
- `<ip>/country_code`
- `<ip>/continent`
- `<ip>/continent_code`
- `<ip>/asn`
- `<ip>/as_name`
- `<ip>/as_domain`

**`https://api.ipinfo.io/batch`**

The default lookup type on this endpoint is `/lookup`, which is a paid-tier feature. Free-tier tokens will get an error. You can optionally use an explicit `lookup/` prefix, but it is not required.

- `<ip>`
- `<ip>/ip`
- `<ip>/hostname`
- `<ip>/geo`
  - `<ip>/city`
  - `<ip>/continent`
  - `<ip>/continent_code`
  - `<ip>/country`
  - `<ip>/country_code`
  - `<ip>/dma_code`
  - `<ip>/geoname_id`
  - `<ip>/latitude`
  - `<ip>/longitude`
  - `<ip>/postal_code`
  - `<ip>/radius`
  - `<ip>/region`
  - `<ip>/region_code`
  - `<ip>/timezone`
- `<ip>/as`
  - `<ip>/as/asn`
  - `<ip>/as/domain`
  - `<ip>/as/last_changed`
  - `<ip>/as/name`
  - `<ip>/as/type`
- `<ip>/anonymous`
  - `<ip>/anonymous/is_proxy`
  - `<ip>/anonymous/is_relay`
  - `<ip>/anonymous/is_res_proxy`
  - `<ip>/anonymous/is_tor`
  - `<ip>/anonymous/is_vpn`
  - `<ip>/anonymous/name`
- `<ip>/mobile`
  - `<ip>/mobile/name`
  - `<ip>/mobile/mcc`
  - `<ip>/mobile/mnc`
- `<ip>/is_anonymous`
- `<ip>/is_anycast`
- `<ip>/is_hosting`
- `<ip>/is_mobile`
- `<ip>/is_satellite`
- `lite/<ip>`
- `lite/<ip>/ip`
- `lite/<ip>/country`
- `lite/<ip>/country_code`
- `lite/<ip>/continent`
- `lite/<ip>/continent_code`
- `lite/<ip>/asn`
- `lite/<ip>/as_name`
- `lite/<ip>/as_domain`
- `<asn>`
- `resproxy/<ip>`
- `places/<ip>`
- `ranges/<domain>`
- `whois/net/<net_id>`
- `whois/net/<ip>`
- `whois/net/<domain>`
- `whois/net/<org_id>`
- `whois/net/<poc_id>`

**`https://api.ipinfo.io/batch/legacy`** / **`https://ipinfo.io/batch`**

This route points to the `ipinfo.io` legacy API. We recommend using it only if you are on the legacy API or need Privacy Extended data.

- `<ip>/ip`
- `<ip>/hostname`
- `<ip>/geo`
  - `<ip>/geo/city` \ `<ip>/city`
  - `<ip>/geo/region` \ `<ip>/region`
  - `<ip>/geo/postal` \ `<ip>/postal`
  - `<ip>/geo/country` \ `<ip>/country`
  - `<ip>/geo/loc` \ `<ip>/loc`
  - `<ip>/geo/timezone` \ `<ip>/timezone`
- `<ip>/asn`
  - `<ip>/asn/asn`
  - `<ip>/asn/domain`
  - `<ip>/asn/name`
  - `<ip>/asn/route`
  - `<ip>/asn/type`
- `<ip>/privacy`
  - `<ip>/privacy/census`
  - `<ip>/privacy/census_ports`
  - `<ip>/privacy/confidence`
  - `<ip>/privacy/coverage`
  - `<ip>/privacy/device_activity`
  - `<ip>/privacy/first_seen`
  - `<ip>/privacy/hosting`
  - `<ip>/privacy/inferred`
  - `<ip>/privacy/last_seen`
  - `<ip>/privacy/proxy`
  - `<ip>/privacy/relay`
  - `<ip>/privacy/service`
  - `<ip>/privacy/tor`
  - `<ip>/privacy/vpn`
  - `<ip>/privacy/vpn_config`
  - `<ip>/privacy/whois`
- `<ip>/company`
  - `<ip>/company/domain`
  - `<ip>/company/name`
  - `<ip>/company/type`
- `<ip>/domains`
  - `<ip>/domains/domains`
  - `<ip>/domains/ip`
  - `<ip>/domains/total`
- `<ip>/abuse`
  - `<ip>/abuse/address`
  - `<ip>/abuse/country`
  - `<ip>/abuse/email`
  - `<ip>/abuse/name`
  - `<ip>/abuse/network`
  - `<ip>/abuse/phone`
- `<ip>/is_anonymous`
- `<ip>/is_anycast`
- `<ip>/is_hosting`
- `<ip>/is_mobile`
- `<ip>/is_satellite`

### Lite Endpoint Option

You can also run batch enrichment against the Lite API:

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

### Input Parameters

**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
AS52188
domains/1.1.1.1
ranges/nytimes.com
resproxy/1.1.1.1
```

```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**

The optional `filter` parameter removes any URLs that have no response from the output. This is useful for cases like finding hostnames that exist across a range of IPs:

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

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

For request volume tracking, the `/batch` call itself is not counted, but every URL inside it is. The filter example above counts as 2 requests, and a single `/batch` call with 100 URLs counts as 100 requests.

The batch endpoint works across all our APIs, including ASN, IP ranges, and hosted domains.

Endpoints and Input Parameters

Batch API

## 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](/account/data-downloads) page to download your IPinfo database.

*Or,* you can go to:

1. your account [Dashboard](/account/home)
2. select [Data Downloads](/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://website-cdn.assets.ipinfo.io/images/developers/database_download_demo.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.

### How downloads are delivered

Requests to `https://ipinfo.io/data/...` return an HTTP `302` redirect to a short-lived signed URL on one of our CDN hosts. Your client then follows the redirect and downloads the file from the CDN — which is why `curl` requires the `-L` flag above, and why most HTTP libraries work out of the box.

If your client runs behind a firewall, web proxy, or corporate egress filter, make sure outbound HTTPS (`TCP/443`) is allowed to each of the following hosts:

- `ipinfo.io` — Endpoint that issues the download redirect
- `api.ipinfo.io` — API endpoint
- `dl.assets.ipinfo.io` — CDN host that serves database files for most accounts (Cloudflare R2)
- `dl.ipinfo.io` — CDN host used by the Splunk integration, and retained as a fallback path
- `storage.googleapis.com` — origin behind `dl.ipinfo.io`; some firewalls and TLS-inspecting proxies need this allowed in addition to `dl.ipinfo.io`

The dual host setup is intentional. `dl.assets.ipinfo.io` provides a Cloudflare-backed fast path, while `dl.ipinfo.io` retains a direct path through Google Cloud Storage for the Splunk integration and as a fallback. Allowlisting both ensures continuity if the routing changes.

The most common failure mode is a firewall that allows `ipinfo.io` but blocks one of the CDN hosts. The first request succeeds with a `302`, but the follow-up download fails — typically as `Connection reset by peer`, an `SSL: CERTIFICATE_VERIFY_FAILED` error, or a silent timeout.

To verify connectivity from your client before configuring the integration:

```bash
curl -I -L "https://ipinfo.io/data/ipinfo_lite.mmdb?token=$TOKEN"
```

A successful run returns a `302` from `ipinfo.io` followed by a `200` from the CDN host. If the second request fails or hangs, the issue is on the redirect target rather than `ipinfo.io` itself.

For the full request flow, client requirements, and troubleshooting guidance, see [How IPinfo Delivers Database Downloads](https://community.ipinfo.io/t/how-ipinfo-delivers-database-downloads/7270) on our community.

Downloading Database

## Available Database Formats

IPinfo databases are available in four file formats, each suited to different use cases:

| Format | Description | Best For |
| --- | --- | --- |
| **CSV** | Plain-text, comma-delimited rows. The most widely supported format for data pipelines. | Bulk ingestion into traditional databases and data warehouses. |
| **MMDB** | A binary format optimized for fast IP address lookups via binary search tree. | High-performance, single-IP lookups in application code. |
| **JSON (NDJSON)** | Newline-delimited JSON records, each with explicit key-value pairs. | Streaming ingestion or systems where CSV parsing is unreliable. |
| **Parquet** | A columnar, fully-typed binary format optimized for analytical queries. | Large-scale analytics in tools like Spark, BigQuery, Snowflake, and Athena. |

Available Database Formats

## 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](/account/data-downloads) on your account dashboard.

The `/data/.../checksums` endpoint is access-controlled the same way as downloads, but checksum requests do not count toward the per-day download cap (e.g. 10/day).

```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](/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](/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

Database Download

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

## [IPinfo Lite](/developers/ipinfo-lite-database)

| File Format | Database Download URI                                                                                                 | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_lite.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_lite.csv**](https://ipinfo.io/data/sample/ipinfo_lite.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_lite.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_lite.json**](https://ipinfo.io/data/sample/ipinfo_lite.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_lite.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_lite.mmdb**](https://ipinfo.io/data/sample/ipinfo_lite.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_lite.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_lite.parquet**](https://ipinfo.io/data/sample/ipinfo_lite.parquet) |

[IPinfo Lite](/developers/ipinfo-lite-database)

## [IPinfo Core](/developers/ipinfo-core-database)

| File Format | Database Download URI                                                                                                  | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_core.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_core.csv**](https://ipinfo.io/data/sample/ipinfo_core.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_core.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_core.json**](https://ipinfo.io/data/sample/ipinfo_core.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_core.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_core.mmdb**](https://ipinfo.io/data/sample/ipinfo_core.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_core.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_core.parquet**](https://ipinfo.io/data/sample/ipinfo_core.parquet) |

[IPinfo Core](/developers/ipinfo-core-database)

## [IPinfo Plus](/developers/ipinfo-plus-database)

| File Format | Database Download URI                                                                                                  | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_plus.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_plus.csv**](https://ipinfo.io/data/sample/ipinfo_plus.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_plus.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_plus.json**](https://ipinfo.io/data/sample/ipinfo_plus.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_plus.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_plus.mmdb**](https://ipinfo.io/data/sample/ipinfo_plus.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_plus.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_plus.parquet**](https://ipinfo.io/data/sample/ipinfo_plus.parquet) |

[IPinfo Plus](/developers/ipinfo-plus-database)

## [Residential Proxy Detection Database](/developers/ip-to-residential-proxy)

| File Format | Database Download URI                                                                                            | Sample Dataset URI                                                                             |
|-------------|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**resproxy_30d.csv.gz**?token=$TOKEN](https://ipinfo.io/data/resproxy_30d.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**resproxy_30d.csv**](https://ipinfo.io/data/sample/resproxy_30d.csv)   |
| **JSON**    | [https://ipinfo.io/data/**resproxy_30d.json.gz**?token=$TOKEN](https://ipinfo.io/data/resproxy_30d.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**resproxy_30d.json**](https://ipinfo.io/data/sample/resproxy_30d.json) |
| **MMDB**    | [https://ipinfo.io/data/**resproxy_30d.mmdb**?token=$TOKEN](https://ipinfo.io/data/resproxy_30d.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**resproxy_30d.mmdb**](https://ipinfo.io/data/sample/resproxy_30d.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**resproxy_30d.parquet**?token=$TOKEN](https://ipinfo.io/data/resproxy_30d.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**resproxy_30d.parquet**](https://ipinfo.io/data/sample/resproxy_30d.parquet) |

[Residential Proxy Detection Database](/developers/ip-to-residential-proxy)

## [IPinfo Device Count](/developers/ip-to-device-count)

| File Format | Database Download URI                                                                                                    |
|-------------|--------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**device-count.csv.gz**?token=$TOKEN](https://ipinfo.io/data/device-count.csv.gz?token=$TOKEN)   |
| **JSON**    | [https://ipinfo.io/data/**device-count.json.gz**?token=$TOKEN](https://ipinfo.io/data/device-count.json.gz?token=$TOKEN) |
| **MMDB**    | [https://ipinfo.io/data/**device-count.mmdb**?token=$TOKEN](https://ipinfo.io/data/device-count.mmdb?token=$TOKEN)       |
| **Parquet** | [https://ipinfo.io/data/**device-count.parquet**?token=$TOKEN](https://ipinfo.io/data/device-count.parquet?token=$TOKEN) |

[IPinfo Device Count](/developers/ip-to-device-count)

## [IPinfo Places Database](/developers/places-database)

| File Format | Database Download URI                                                                                          |
| ----------- | -------------------------------------------------------------------------------------------------------------- |
| **CSV**     | [https://ipinfo.io/data/**poi_all.csv.gz**?token=$TOKEN](https://ipinfo.io/data/poi_all.csv.gz?token=$TOKEN)   |
| **JSON**    | [https://ipinfo.io/data/**poi_all.json.gz**?token=$TOKEN](https://ipinfo.io/data/poi_all.json.gz?token=$TOKEN) |
| **MMDB**    | [https://ipinfo.io/data/**poi_all.mmdb**?token=$TOKEN](https://ipinfo.io/data/poi_all.mmdb?token=$TOKEN)       |
| **Parquet** | [https://ipinfo.io/data/**poi_all.parquet**?token=$TOKEN](https://ipinfo.io/data/poi_all.parquet?token=$TOKEN) |

[IPinfo Places Database](/developers/places-database)

## [IP to Geolocation Database](/developers/ip-to-geolocation-database)

| File Format | Database Download URI                                                                                                          | Sample Dataset URI                                                                                           |
|-------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_location.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_location.csv**](https://ipinfo.io/data/sample/ipinfo_location.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_location.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_location.json**](https://ipinfo.io/data/sample/ipinfo_location.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_location.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_location.mmdb**](https://ipinfo.io/data/sample/ipinfo_location.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_location.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_location.parquet**](https://ipinfo.io/data/sample/ipinfo_location.parquet) |

[IP to Geolocation Database](/developers/ip-to-geolocation-database)

## [ASN Database](/developers/asn-database)

| File Format | Database Download URI                                                                                                | Sample Dataset URI                                                                                 |
|-------------|----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_asn.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_asn.csv**](https://ipinfo.io/data/sample/ipinfo_asn.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_asn.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_asn.json**](https://ipinfo.io/data/sample/ipinfo_asn.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_asn.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_asn.mmdb**](https://ipinfo.io/data/sample/ipinfo_asn.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_asn.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_asn.parquet**](https://ipinfo.io/data/sample/ipinfo_asn.parquet) |

[ASN Database](/developers/asn-database)

## [IP to Privacy Detection Database](/developers/privacy-detection-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_privacy.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_privacy.csv**](https://ipinfo.io/data/sample/ipinfo_privacy.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_privacy.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_privacy.json**](https://ipinfo.io/data/sample/ipinfo_privacy.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_privacy.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_privacy.mmdb**](https://ipinfo.io/data/sample/ipinfo_privacy.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_privacy.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_privacy.parquet**](https://ipinfo.io/data/sample/ipinfo_privacy.parquet) |

[IP to Privacy Detection Database](/developers/privacy-detection-database)

## [IP to Company Database](/developers/ip-to-company-database)

| File Format | Database Download URI                                                                                                            | Sample Dataset URI                                                                           |
|-------------|----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_company.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_company.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**company.csv**](https://ipinfo.io/data/sample/company.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_company.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_company.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**company.json**](https://ipinfo.io/data/sample/company.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_company.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_company.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**company.mmdb**](https://ipinfo.io/data/sample/company.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**standard_company.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_company.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**company.parquet**](https://ipinfo.io/data/sample/company.parquet) |

[IP to Company Database](/developers/ip-to-company-database)

## [IP to Mobile Carrier Database](/developers/ip-to-mobile-carrier-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_carrier.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_carrier.csv**](https://ipinfo.io/data/sample/ipinfo_carrier.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_carrier.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_carrier.json**](https://ipinfo.io/data/sample/ipinfo_carrier.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_carrier.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_carrier.mmdb**](https://ipinfo.io/data/sample/ipinfo_carrier.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_carrier.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_carrier.parquet**](https://ipinfo.io/data/sample/ipinfo_carrier.parquet) |

[IP to Mobile Carrier Database](/developers/ip-to-mobile-carrier-database)

## [Hosted Domains Database](/developers/hosted-domains-database)

| File Format | Database Download URI                                                                                                                                | Sample Dataset URI                                                                                                                 |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_ip_hosted_domains.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.csv**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.json**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.mmdb**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.parquet?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.parquet**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.parquet) |

[Hosted Domains Database](/developers/hosted-domains-database)

## [Abuse Contact Database](/developers/abuse-contact-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_abuse.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**standard_abuse.csv**](https://ipinfo.io/data/sample/standard_abuse.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_abuse.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**standard_abuse.json**](https://ipinfo.io/data/sample/standard_abuse.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_abuse.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_abuse.mmdb**](https://ipinfo.io/data/sample/standard_abuse.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**standard_abuse.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**standard_abuse.parquet**](https://ipinfo.io/data/sample/standard_abuse.parquet) |

[Abuse Contact Database](/developers/abuse-contact-database)

## [RIR WHOIS](/developers/ip-whois-database#rir-whois-database)

| File Format | Database Download URI                                                                                  | Sample Dataset URI                                                                   |
|-------------|--------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**rir.csv.gz**?token=$TOKEN](https://ipinfo.io/data/rir.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**rir.csv**](https://ipinfo.io/data/sample/rir.csv)   |
| **JSON**    | [https://ipinfo.io/data/**rir.json.gz**?token=$TOKEN](https://ipinfo.io/data/rir.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.json**](https://ipinfo.io/data/sample/rir.json) |
| **MMDB**    | [https://ipinfo.io/data/**rir.mmdb**?token=$TOKEN](https://ipinfo.io/data/rir.mmdb?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.mmdb**](https://ipinfo.io/data/sample/rir.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**rir.parquet**?token=$TOKEN](https://ipinfo.io/data/rir.parquet?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.parquet**](https://ipinfo.io/data/sample/rir.parquet) |

[RIR WHOIS](/developers/ip-whois-database#rir-whois-database)

## [RWHOIS](/developers/ip-whois-database#rwhois-database)

| File Format | Database Download URI                                                                                        | Sample Dataset URI                                                                         |
|-------------|--------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**rwhois.csv.gz**?token=$TOKEN](https://ipinfo.io/data/rwhois.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**rwhois.csv**](https://ipinfo.io/data/sample/rwhois.csv)   |
| **JSON**    | [https://ipinfo.io/data/**rwhois.json.gz**?token=$TOKEN](https://ipinfo.io/data/rwhois.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.json**](https://ipinfo.io/data/sample/rwhois.json) |
| **MMDB**    | [https://ipinfo.io/data/**rwhois.mmdb**?token=$TOKEN](https://ipinfo.io/data/rwhois.mmdb?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.mmdb**](https://ipinfo.io/data/sample/rwhois.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**rwhois.parquet**?token=$TOKEN](https://ipinfo.io/data/rwhois.parquet?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.parquet**](https://ipinfo.io/data/sample/rwhois.parquet) |

[RWHOIS](/developers/ip-whois-database#rwhois-database)

## [IP to Geolocation Extended Database](/developers/ip-to-geolocation-extended)

| File Format | Database Download URI                                                                                                                    | Sample Dataset URI                                                                                                     |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**location_extended_v2.csv.gz**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**location_extended_v2.csv**](https://ipinfo.io/data/sample/location_extended_v2.csv)   |
| **JSON**    | [https://ipinfo.io/data/**location_extended_v2.json.gz**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**location_extended_v2.json**](https://ipinfo.io/data/sample/location_extended_v2.json) |
| **MMDB**    | [https://ipinfo.io/data/**location_extended_v2.mmdb**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**location_extended_v2.mmdb**](https://ipinfo.io/data/sample/location_extended_v2.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**location_extended_v2.parquet**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.parquet?token=$TOKEN)       | [https://ipinfo.io/data/sample/**location_extended_v2.parquet**](https://ipinfo.io/data/sample/location_extended_v2.parquet) |

[IP to Geolocation Extended Database](/developers/ip-to-geolocation-extended)

## [IP to Privacy Detection Extended Database](/developers/privacy-detection-extended)

| File Format | Database Download URI                                                                                                                          | Sample Dataset URI                                                                                                           |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_privacy_extended.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.csv**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_privacy_extended.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.json**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_privacy_extended.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.mmdb**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_privacy_extended.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_privacy_extended.parquet**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.parquet) |


If you are interested in learning which database format suits your needs, check out our article: **[How to choose the best file format for your IPinfo database?](https://ipinfo.io/blog/ipinfo-database-formats/)**

[IP to Privacy Detection Extended Database](/developers/privacy-detection-extended)

Database Filenames

IPinfo Lite

IPinfo Core

IPinfo Plus

IP to Geolocation

Privacy Detection

IP to Residential Proxy

IP to Device Count

IPinfo Places

IP to Company

ASN Database

IP to Mobile Carrier

Hosted Domains

Abuse Contact

IP WHOIS

IP to Geolocation Extended

Privacy Detection Extended

# IP Database Types

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

The IPinfo Lite database is part of our [free IP data downloads offering](/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 Core Database

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

> Database downloads are a separate enterprise offering and are not included in [IPinfo Core API](/developers/core-api) self-serve plans. Please [contact our sales team](/contact) for enterprise pricing and access.

# IPinfo Plus Database

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.

> Database downloads are a separate enterprise offering and are not included in [IPinfo Plus API](/developers/plus-api) self-serve plans. Please [contact our sales team](/contact) for enterprise pricing and access.

# IP to Geolocation Database

[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 Privacy Detection Database

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

> **Extended Tor coverage available on request:** The standard database includes Tor exit node IPs only. IPinfo also captures entry/guard nodes and middle relays. Enterprise customers can request a customized database download that includes additional Tor relay types. [Contact our sales team](/contact) to learn more.

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/qHTaCHwSYRg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

# IP to Residential Proxy Database

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.

# IP to Device Count Database

The [IP to Device Count dataset](/data/device-count) provides network-level intelligence on how many devices share an IP address and whether that sharing is concurrent or rotating over time. This goes far beyond simple "[residential](/data/ip-asn)" or "[mobile](/data/ip-carrier)" labels. The IP to Device Count database reveals whether an IP is used by 1 device, 10, or 10,000+, and whether that sharing happens all at once (concurrent CGNAT) or one device at a time with ISP rotation (dynamic residential).

The database covers currently (as of April 10, 2026) 7.7 million networks globally, with 1.3 million networks exhibiting daily device sharing patterns, and includes validated coverage for major carriers worldwide.

> **Status:** Alpha (Early Access)

# IPinfo Places Database

The [IPinfo Places](/data/places) database maps IP addresses to the real-world venues and buildings they are observed on, including hotels, airports, museums, stadiums, transit stations, and 70+ other location categories. Each record links an IP to a verified physical place, the Wi-Fi SSID observed at that venue, and the building-level coordinates of the matched place.

The database is built on top of active measurements and curated GIS data, allowing customers to enrich IP data with venue context for security, ad tech, fraud prevention, and audience analytics use cases.

The IPinfo Places data currently maps static IPs to Places of Interest. We are currently excluding dynamic IP addresses.

> **Status:** Enterprise Beta

# IP to Company Database

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.

# ASN Database

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.

# IP to Mobile Carrier Database

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

# Hosted Domains Database

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

# IP Abuse Contact Database

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

# IP WHOIS

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 to Geolocation Extended Database

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 Privacy Detection Extended Database

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.

> **Extended Tor coverage available on request:** The standard database includes Tor exit node IPs only. IPinfo also captures entry/guard nodes and middle relays. Enterprise customers can request a customized database download that includes additional Tor relay types. [Contact our sales team](/contact) to learn more.

Database Types

# Integrations Overview

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](/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)
- [Microsoft Sentinel](/developers/microsoft-sentinel)
- [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).

## Platform Integrations

- [Auth0](https://marketplace.auth0.com/integrations/ipinfo)
- [Beam AI](https://beam.ai/integrations/ipinfoio)
- [Crowdstrike SOAR Action](https://marketplace.crowdstrike.com/listings/ipinfo-io-soar-actions/)
- [Dropzone AI](https://docs.dropzone.ai/integrations/data/ipinfo-io)
- [Heroku](https://elements.heroku.com/addons/ipinfo)
- [Integrately](https://integrately.com/integrations/ipinfo)
- [Lindy](https://www.lindy.ai/integrations/ipinfo-io)
- [n8n](https://n8n.io/integrations/ipinfo/)
- [Palo Alto Cortex](https://cortex.marketplace.pan.dev/marketplace/details/ipinfo/)
- [Pipedream](https://pipedream.com/apps/ipinfo-io)
- [Relevance AI](https://relevanceai.com/integrations/ipinfo-io)
- [Rube](https://rube.app/marketplace/ipinfo_io)
- [Sumo Logic](https://www.sumologic.com/help/docs/platform-services/automation-service/app-central/integrations/ipinfo/)
- [Zapier](https://zapier.com/apps/ipinfo/integrations)

Platform Integrations

Integrations Overview

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

## IPinfo on the Snowflake Marketplace

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/jMP6frL5mZw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

You can check out our IP databases from [our storefront](https://app.snowflake.com/marketplace/listings/IPinfo) as well. Each listing page contains a description of the product, available column/field names, use cases, sample queries, and other useful information to get you up and running. We currently have the following IP datasets available in the Snowflake Marketplace.

| Product                                                                                                             | Description                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [IPinfo Lite](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55S)                                           | Open access, full-accuracy IP datasets that provide IP-to-country and ASN details.                                                                           |
| [IPinfo Core](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56D)                                           | City-level precision and network connection context (anonymous+, satellite, and carrier).                                                                       |
| [IPinfo Plus](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56H)                                           | Comprehensive IP intelligence, including location, anonymity/privacy, ASN, carrier, and stability.                                                            |
| [IPinfo Residential Proxy](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55W)                              | Detect residential and mobile proxy IPs with service and usage metrics.                                                                                       |
| [IPinfo IP Geolocation](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFI)                                  | Accurate IP location with detailed and granular precision.                                                                                                    |
| [IPinfo Company IP Address Data](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMEX)                         | Identify companies and organizations through IP addresses.                                                                                                    |
| [IPinfo Privacy Detection (VPN, TOR, Relay, Proxy etc.)](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFU) | Detect hosting, VPN, proxy, Relay and Tor IPs.                                                                                                                |
| [Comprehensive IP WHOIS Data](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFY)                            | Structured IP WHOIS data for ASN, Organization, Maintainer, Network & POC Records                                                                             |
| [IPinfo: IP Geolocation Training/Education Sample](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMEH)       | Snowflake's "[The Hands-On Essentials Workshop Series](https://www.snowflake.com/en/resources/learn/snowflake-essentials-training/)" workshop practices data. |

Custom API	Self-Serve Alternative	Description
IP Geolocation	IPinfo Core	Includes full geolocation information
IP Geolocation	IPinfo Plus / IPinfo Max	Includes full geolocation plus additional accuracy metadata
IP to ASN	IPinfo Core	Includes full ASN information
IP to ASN	IPinfo Plus / IPinfo Max	Includes full ASN plus last change information
Privacy Detection API	IPinfo Core	Includes privacy/anonymous IP data via IP connection type data
	IPinfo Plus	Includes full privacy data
	IPinfo Max	Includes full privacy data and residential proxy data
IP to Residential Proxy	IPinfo Max	Includes full privacy data and residential proxy data
Carrier Detection (Mobile IP Data) API	IPinfo Core	Includes carrier flag via IP connection type field
Carrier Detection (Mobile IP Data) API	IPinfo Plus / IPinfo Max	Includes full carrier information