IPinfo Lite API

Available for: Every IPinfo user

The IPinfo Lite API is our free-tier API access plan, which includes unlimited country-level geolocation information and unlimited basic ASN information. Geolocation information provided by the IPinfo Lite API service includes country and continent information, while ASN information includes ASN, organization name, and domain name.

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

You can access IPinfo Lite data as a downloadable dataset as well: IPinfo Lite IP Data Downloads

Quick Reference

IPinfo Lite API URL breakdown

API Schema

JSON

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo Lite API Response",
  "description": "Schema for IPinfo Lite API response",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address being queried.",
      "example": "8.8.8.8"
    },
    "asn": {
      "type": "string",
      "description": "The Autonomous System Number (ASN) identifying the organization that owns or operates the IP address.",
      "example": "AS15169"
    },
    "as_name": {
      "type": "string",
      "description": "The official name of the Autonomous System (AS) organization.",
      "example": "Google LLC"
    },
    "as_domain": {
      "type": "string",
      "description": "The official domain name of the Autonomous System (AS) organization.",
      "example": "google.com"
    },
    "country_code": {
      "type": "string",
      "description": "The ISO 3166 country code (ISO 3166-1 alpha-2).",
      "example": "US"
    },
    "country": {
      "type": "string",
      "description": "The country where the IP address is located.",
      "example": "United States"
    },
    "continent_code": {
      "type": "string",
      "description": "The two-letter continent code.",
      "example": "NA"
    },
    "continent": {
      "type": "string",
      "description": "The continent where the IP address is located.",
      "example": "North America"
    }
  },
  "required": ["ip"]
}

Field	Description	Example
`ip`	The client IP address or IP address being queried	`8.8.8.8`
`asn`	Autonomous System Number	`AS15169`
`as_name`	Organization name	`Google LLC`
`as_domain`	Organization's domain name	`google.com`
`country_code`	Two-letter country code (ISO 3166-1 alpha-2)	`US`
`country`	Full country name	`United States`
`continent_code`	Two-letter continent code	`NA`
`continent`	Full continent name	`North America`

Lookup IP addresses

Bash

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

JSON

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

Get information on your or visitors' IP address:

Bash

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

JSON

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

IP Address Types

Bash

https://api.ipinfo.io/lite/64.189.247.110?token=$TOKEN

JSON

{
  "ip": "64.189.247.110",
  "asn": "AS54607",
  "as_name": "Apogee Telecom Inc.",
  "as_domain": "apogee.us",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}

API Endpoint Breakdown

The API endpoint also supports explicit declaration of IP address connections (IPv4/IPv6).

Description	Endpoint type	Endpoint
General (Dual Stacked)	Self / Client IP	`curl https://api.ipinfo.io/lite/me?token=$TOKEN`
General (Dual Stacked)	Lookup / Target IP	`curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN`
IPv4	Self / Client IP	`curl https://v4.api.ipinfo.io/lite/me?token=$TOKEN`
IPv4	Lookup / Target IP	`curl https://v4.api.ipinfo.io/lite/8.8.8.8?token=$TOKEN`
IPv6	Self / Client IP	`curl https://v6.api.ipinfo.io/lite/me?token=$TOKEN`
IPv6	Lookup / Target IP	`curl https://v6.api.ipinfo.io/lite/8.8.8.8?token=$TOKEN`

The general API endpoint is built to support both IPv4 and IPv6 connections, ensuring you can call it from either without any issues.

If the IP is anycast or bogon, an additional field is returned indicating that.

Check out the code snippets section for IPinfo Lite API related code and responses.

Bulk / Batch Enrichment

The bulk API endpoint can enrich up to 1,000 requests per call.

Full Record Lookup

Use a JSON array of IPs to return full Lite records for each IP.

Bash

curl -XPOST --data '["216.66.251.30", "187.206.182.231", "94.30.95.36", "31.251.149.240"]' "https://api.ipinfo.io/batch/lite?token=$TOKEN"

Response

JSON

{
  "216.66.251.30": {
    "ip": "216.66.251.30",
    "asn": "AS11123",
    "as_name": "Ultimate Internet Access, Inc",
    "as_domain": "uia.net",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "31.251.149.240": {
    "ip": "31.251.149.240",
    "asn": "AS3320",
    "as_name": "Deutsche Telekom AG",
    "as_domain": "telekom.de",
    "country_code": "DE",
    "country": "Germany",
    "continent_code": "EU",
    "continent": "Europe"
  },
  "187.206.182.231": {
    "ip": "187.206.182.231",
    "asn": "AS8151",
    "as_name": "UNINET",
    "as_domain": "telmex.com",
    "country_code": "MX",
    "country": "Mexico",
    "continent_code": "NA",
    "continent": "North America"
  },
  "94.30.95.36": {
    "ip": "94.30.95.36",
    "asn": "AS5413",
    "as_name": "Wavenet Limited",
    "as_domain": "wavenet.co.uk",
    "country_code": "GB",
    "country": "United Kingdom",
    "continent_code": "EU",
    "continent": "Europe"
  }
}

Was this page helpful?

IPinfo APIsPrevious

IPinfo Core APINext