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

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

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

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

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

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

IPinfo Enterprise API

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

## Authentication

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

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

[IPinfo Lite](/developers/lite-api) is our free tier API service available to all users.


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

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

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

<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 Lookup">

IPinfo Lookup is available to users of [IPinfo Core](/developers/core-api) and [IPinfo Plus](/developers/plus-api).

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

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

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

<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 Legacy">

IPinfo Legacy Service is available to our legacy and [enterprise API users](/developers/enterprise-api).

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

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

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

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

  <Tab title="IPinfo Resproxy">

[IPinfo Resproxy API](/developers/residential-proxy-api) service to detect residential proxy IPs.


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

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

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

<details>

<summary>API Response</summary>

```json
{
  "ip": "175.107.211.204",
  "last_seen": "2026-01-10",
  "percent_days_seen": 100,
  "service": "PYPROXY"
}
```

</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 offers unlimited access to our API. Paid plans include monthly request limits with configurable alerts to help you stay in control. If you exceed your plan’s limit, you’ll receive a 429 HTTP status code—but with metered billing, you can automatically extend your usage without interruptions.

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

Rate Limits

## Filtering Responses

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

<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
# Get the ASN
curl https://api.ipinfo.io/lookup/8.8.8.8/asn?token=$TOKEN
AS15169

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

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

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

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

Filtering Responses

## Dual Stack API Service

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

The examples below show how to force IPv4 or IPv6 connections using the `-4` and `-6` flags with curl.

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

On IPv4 Connection:

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


<details>

<summary>API Response</summary>

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

</details>

---

On IPv6 Connection:

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

<details>

<summary>API Response</summary>

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

</details>

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

On IPv4 Connection:

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

<details>

<summary>API Response</summary>

```json
{
  "ip": "2602:f8de::",
  "geo": {
    "city": "Sheridan",
    "region": "Wyoming",
    "region_code": "WY",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 44.79719,
    "longitude": -106.95618,
    "timezone": "America/Denver",
    "postal_code": "82801",
    "dma_code": "764",
    "geoname_id": "5838198",
    "radius": 20,
    "last_changed": "2024-08-04"
  },
  "as": {
    "last_changed": "2025-10-02"
  },
  "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
}
```

</details>

---

On IPv6 Connection:

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

<details>

<summary>API Response</summary>

```json
{
  "ip": "102.135.36.0",
  "geo": {
    "city": "Victoria",
    "region": "La Rivière Anglaise",
    "region_code": "16",
    "country": "Seychelles",
    "country_code": "SC",
    "continent": "Africa",
    "continent_code": "AF",
    "latitude": -4.62001,
    "longitude": 55.45501,
    "timezone": "Indian/Mahe",
    "geoname_id": "241131",
    "radius": 5000,
    "last_changed": "2025-12-07"
  },
  "as": {
    "asn": "AS9009",
    "name": "M247 Europe SRL",
    "domain": "m247global.com",
    "type": "hosting",
    "last_changed": "2025-09-04"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>

  </Tab>
</Tabs>

### Explicit IPv4 and IPv6 endpoint

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

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

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

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

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

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

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

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

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

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

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

Getting Started

IPinfo Lite API

IPinfo Core API

IPinfo Business API

Geolocation API

Privacy Detection API

Residential Proxy API

Privacy Extended API

ASN API

IP Ranges API

Hosted Domains API

IP Whois API

# IPinfo Lite API Developer Resource

**Available for**: Every IPinfo user

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

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

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

# IPinfo Core API Developer Resource

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

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

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

# IPinfo Plus API Developer Resource

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

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

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

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

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

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

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

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

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

# IPinfo Enterprise

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

**IP Ranges API**

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

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

**Hosted Domains API**

The [Hosted Domains API](/data/hosted-domains) in the IPinfo Enterprise plan, you can get up to 1000 domains.

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

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

# Geolocation API Developer Resource

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

The Geolocation API allows you to programmatically access detailed location data for any IP address, including city, region, country, geographic coordinates, timezone, and postal code. The Geolocation API is available at `/{ip}/geo`.

# Privacy Detection API Developer Resource

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

The Privacy Detection API allows you to programmatically identify IP addresses associated with privacy services such as VPNs, proxies, Tor exit nodes, anonymous relays, and hosting/data center providers. The Privacy Detection API is available at `/{ip}/privacy`.

# Residential Proxy Detection API

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

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

# Privacy Detection API (Extended)

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

# ASN API Developer Resource

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

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

# IP Ranges Developer Resource

**Available in**: IPinfo Enterprise

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

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

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

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

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

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

# Hosted Domains API Developer Resource

**Available in**: IPinfo Enterprise

Our Hosted Domains, or [Reverse IP API](/data/hosted-domains) returns a list of all of the domains hosted on the provided IP address. IPinfo Enterprise plan users receive up to 1,000 domains per API request.

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

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

# IP Whois API Developer Resource

**Available in**: IPinfo Enterprise

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

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

IPinfo APIs

# IP Data Types Developer Resource

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

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

## Geolocation Data

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Geolocation Data

## ASN Data

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ASN Data

## IP Privacy Detection Data

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

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

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

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

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

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

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

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

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


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

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

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

IP Privacy Detection Data

## Carrier or Mobile IP Data

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

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

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

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

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

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

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

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

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

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

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

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

Carrier or Mobile IP Data

## Company Data

**Available in**: [IPinfo Enterprise](/developers/enterprise-api)

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

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

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

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

Company Data

## Hosted Domains Data

**Available in**: [IPinfo Enterprise](/developers/enterprise-api)

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

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

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

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

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

[IPinfo Enterprise](/developers/enterprise-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**: [IPinfo Enterprise](/developers/enterprise-api)

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

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

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

Abuse Contact Data

## IP Type Data

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

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

**Bogon Address Information**

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

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

**Anycast Information**

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

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

IP Type Data

Data Types

## Bulk/Batch API

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

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

**Batch URL endpoints**

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

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

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

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

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

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

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

**Why URL patterns?**

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


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

**Usage**

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

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


**JSON Array**

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


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


**Newline-separated list of IPs**

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

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

**Space-separated list of IPs**

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

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

**List of IP addresses**

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

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

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

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

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

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


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

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

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

**Filter Option**

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

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

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

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

Bulk/Batch API

## Command Line Interface (CLI)

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

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

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

Command Line Interface (CLI)

Advanced Usage

Database Filenames

# IP Database Download Developer Resource

## Downloading Database

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

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

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

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

*Or,* you can go to:

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

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

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

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

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

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

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

Downloading Database

## Database Operations

### Getting specific country location

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

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

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

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

### Filtering the database with multiple countries/ASNs

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

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

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

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

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

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

### Convert IP addresses to IP ranges

### Convert IP addresses to IP ranges

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

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

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

How to use the range2cidr command:

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

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

### Exploring `MMDB` files using mmdbctl

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

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

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

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

Database Operations

## MMDB reader libraries

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

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

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

MMDB reader libraries

## Downloads Rate limit

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

Downloads Rate limit

## Checksums 

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

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

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

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

Checksums

## Cloud Data Delivery

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

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

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

Cloud Data Delivery

## Ecosystem Integrations

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

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

Some of the platforms we currently support are:

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

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

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

Ecosystem Integrations

## Column/Field Types

Field types can differ depending on the download format:

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

Column/Field Types

## Database Guides

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

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

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

Database Guides

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

Database Download

IPinfo Lite

IPinfo Core

IPinfo Plus

IP to Geolocation

Privacy Detection

IP to Residential Proxy

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 Developer Resource

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

IPinfo Bundle Databases

## Standard Databases

Our paid databases include the following:

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

Standard Databases

## Extended Databases

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

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

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

Extended Databases

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

# IPinfo Core Database Developer Resource

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

# IPinfo Plus Database Developer Resource

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

# IP to Geolocation Database Developer Resource

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

# IP Privacy Detection Database Developer Resource

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

<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 Developer Resource

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

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

# IP to Company Database Developer Resource

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

# ASN Database Developer Resource

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

# IP to Mobile Carrier Database Developer Resource

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

# Hosted Domains Database Developer Resource

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

# IP Abuse Contact Database

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

# IP WHOIS Developer Resource

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

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

# IP to Geolocation Extended Database Developer Resource

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

# IP Privacy Detection Extended Database Developer Resource

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

Database Types

Snowflake

Splunk

Google Cloud / BigQuery

Integration Guideline

# IP Data Integrations and Data Platforms

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

The current list of IPinfo Platform integrations includes:

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

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

# IPinfo 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 Splunk App Installation & Configuration

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

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

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

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

# IPinfo on Google Cloud Platform

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

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

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

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

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

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

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

Integrations

# Code Snippets

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

## General Code Snippets

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

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

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

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

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

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

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

The command will provide a link for your IPinfo map.

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

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

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

General Code Snippets

## Lite API Snippets

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response*:

```text
82.163.118.147
```

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

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

*Response*:

```text
AS57276
```

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

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

```text
Vorboss Limited
```

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

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

*Response*:

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

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

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

*Response*:

```text
GB
```

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

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

*Response*:

```text
United Kingdom
```

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

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

*Response*:

```text
EU
```

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

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

*Response*:

```text
Europe
```

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

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


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

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

Lite API Snippets

## Core API Snippets

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response*:

```text
Mississauga
```

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

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

*Response*:

```text
Ontario
```

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

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

*Response*:

```text
ON
```

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

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

*Response*:

```text
Canada
```

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

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

*Response*:

```text
CA
```

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

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

*Response*:

```text
North America
```

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

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

*Response*:

```text
NA
```

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

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

*Response*:

```text
43.5789
```

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

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

*Response*:

```text
-79.6583
```

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

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

*Response*:

```text
America/Toronto
```

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

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

*Response*:

```text
L5C
```

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

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

*Response:*

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


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

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

*Response*:

```text
AS5645
```

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

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

*Response*:

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

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

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

*Response*:

```text
teksavvy.com
```

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

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

*Response*:

```text
isp
```


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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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


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

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

Core API Snippets

## Plus API Snippets

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response:*

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

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

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

*Response*:

```text
Rome
```

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

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

*Response*:

```text
Lazio
```

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

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

*Response*:

```text
62
```

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

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

*Response*:

```text
Italy
```

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

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

*Response*:

```text
IT
```

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

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

*Response*:

```text
Europe
```

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

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

*Response*:

```text
EU
```

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

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

*Response*:

```text
41.89193
```

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

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

*Response*:

```text
12.51133
```

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

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

*Response*:

```text
Europe/Rome
```

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

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

*Response*:

```text
00118
```

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

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

*Response*:

```text
534
```

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

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

*Response*:

```text
3169070
```

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

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

*Response*:

```text
1000
```

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

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

*Response*:

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

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

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

*Response:*

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


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

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

*Response*:

```text
AS3269
```

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

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

*Response*:

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

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

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

*Response*:

```text
telecomitalia.com
```

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

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

*Response*:

```text
isp
```

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

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

*Response*:

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


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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

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

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

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

*Response*:

```text
TIM
```

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

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

*Response*:

```text
222
```

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

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

*Response*:

```text
01
```

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

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

*Response*:

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

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
false
```

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

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

*Response*:

```text
true
```

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

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

*Response*:

```text
ExpressVPN
```

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

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


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

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

Plus API Snippets

Code Snippets

# IPinfo OpenAPI Specification & LLM resources

## OpenAPI Spec

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

This specification is intended for integration demos, client generation, and any tooling that consumes standard OpenAPI/Swagger definitions. You can access the raw OpenAPI YAML file here: [https://ipinfo.io/developers/openapi.yaml](/developers/openapi.yaml)

OpenAPI Spec

## LLM Resources

IPinfo provides LLM-optimized documentation in two formats for AI assistants and language models.

### llms.txt

A clean table of contents linking to all documentation pages. Ideal for quick navigation and token-efficient parsing: [https://ipinfo.io/developers/llms.txt](/developers/llms.txt)


### llms-full.txt

Complete developer documentation in a single aggregated file. All pages combined with HTML-to-markdown conversion applied: [https://ipinfo.io/developers/llms-full.txt](/developers/llms-full.txt)

LLM Resources

## Ask AI

- [Open IPinfo Docs in ChatGPT](https://chatgpt.com/?q=Read%20the%20IPinfo%20Docs%20from%20here%2C%20and%20answer%20questions%3A%20https%3A%2F%2Fipinfo.io%2Fdevelopers%2Fllms-full.txt)
- [Open IPinfo Docs in Claude](https://claude.ai/new?q=Read%20the%20IPinfo%20Docs%20from%20here%2C%20and%20answer%20questions%3A%20https%3A%2F%2Fipinfo.io%2Fdevelopers%2Fllms-full.txt)
- [Open IPinfo Docs in Perplexity](https://chatgpt.com/?q=Read%20the%20IPinfo%20Docs%20from%20here%2C%20and%20answer%20questions%3A%20https%3A%2F%2Fipinfo.io%2Fdevelopers%2Fllms-full.txt)

Ask AI

OpenAPI Spec & LLM

# Official API Supported Libraries Developer Resource

## For programming languages

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

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

For programming languages

## For frameworks

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

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

For frameworks

## Command Line Interface (CLI)

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

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

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

## Third party libraries

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

Third party libraries

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

Libraries

# Guides & Tutorials

Explore our collection of practical guides and tutorials to help you get the most out of IPinfo's products and APIs.

## Blog & FAQs

Visit our [How-To Guides](/blog/tag/how-to) section for step-by-step tutorial. You can also check out our [FAQ Section](/faq) section.