IP ASN Database Lite

Overview

Our IP to ASN Database lets you resolve any IPv4 or IPv6 address to its Autonomous System Number (ASN) and owning organization, complete with AS name, ISP/organization, announced prefixes, and routing context. Built from continuously refreshed registry and BGP sources, it helps you attribute traffic, understand upstreams and peering, and spot misroutes or policy drift across your network edge.

Updated regularly and delivered in flexible formats (CSV, JSON, MMDB, or via API), each record includes ASN, AS name, organization, country/registry, prefix and prefix length, announcement status, and related metadata useful for enrichment and routing analysis. Below you’ll find the full documentation: field definitions, file specs, example responses, and integration notes for SIEM/SOAR, NetOps, and threat-intel pipelines.

Available Database Formats

CSV

File Size: 181.79 MB

Entries: 29.9M

Fields: 7

Last Updated: Today

Documentation

MMDB

File Size: 14.20 MB

Entries: 29.9M

Fields: 7

Last Updated: Today

Documentation

CSV Database Documentation

1. Overview

The CSV version is a set of Gzip-compressed CSV files containing IP ranges and their ASN information. Designed for bulk imports and integration into relational databases.

2. Archive Content

After downloading and extracting the IP to ASN (Lite) CSV database archive, you'll find the following files (with their types noted):

db-asn-details.csv.gz

Gzip-compressed CSV provides ASN info: number, organization, domain, type, and country.

File Size: 2.68 MB

Entries: 130.0K

Fields: 6

db-ip-asn.csv.gz

Each start_ip, end_ip links to the ASN details ID that is related to the asn-details file.

File Size: 179.12 MB

Entries: 29.9M

Fields: 3

README.md

Documentation for dataset contents, schema, usage, and support.

File Size: 4.55 KB

checksum.txt

SHA-256 checksums for verifying file integrity.

File Size: 247 Bytes

Schema

This section describes the schema of each file included in the IP to ASN (Lite) Database archive. For every file, you'll find its purpose, field definitions, and examples to help with integration.

1. db-ip-asn.csv.gz

This file contains IP address ranges linked to ASN information. It maps each IP block to a unique asn_details_id, which in turn corresponds to the AS's organization, domain, type, and country.

Field	Type	Description	Can be empty?	Example
start_ip	string	The starting IP address of the range in IPv4 or IPv6 format.	No	192.168.0.1
end_ip	string	The ending IP address of the range in IPv4 or IPv6 format.	No	192.168.0.255
id	number	The unique identifier for the ASN details.	No	1

I. Example Records

Example

start_ip,end_ip,asn_details_id
218.33.121.178,218.33.121.178,39610
145.239.113.116,145.239.113.119,123241
114.207.162.47,114.207.162.47,87409
168.235.91.179,168.235.91.179,1236
2.72.231.161,2.72.231.161,104976
128.189.247.228,128.189.247.228,69789
138.43.166.223,138.43.168.193,99653
70.23.104.30,70.23.104.30,29283
92.90.59.0,92.90.59.255,109135
135.131.151.252,135.131.151.252,13303

2. db-asn-details.csv.gz

This file contains detailed Autonomous System Number (ASN) information. Each entry links a unique ID to an AS number, organization, domain, type, and country.

Field	Type	Description	Can be empty?	Example
id	number	The unique identifier for the ASN details.	No	1
as_number	string	The Autonomous System Number (ASN).	No	AS15169
organization	string	The organization associated with the ASN.	No	Google LLC
domain	string	The domain associated with the ASN.	Yes	google.com
type	string	The type of network associated with the ASN (e.g., business, residential, etc.).	No	business
country	string	The country where the ASN is registered.	No	US

I. Example Records

Example

id,as_number,organization,domain,type,country
39610,58369,PT. Fiber Networks Indonesia,fiber.net.id,BUSINESS,ID
123241,16276,OVH SAS,ovh.net,HOSTING,FR
99653,395437,Highland Communications LLC,highlandtel.net,ISP,US
104976,29355,Kcell JSC,kcell.kz,BUSINESS,KZ
69789,393249,University of British Columbia,ubc.ca,EDUCATION,CA
87409,9318,SK Broadband Co Ltd,skbroadband.com,ISP,KR
1236,3842,"InMotion Hosting, Inc.",inmotionhosting.com,HOSTING,US
13303,4181,TDS TELECOM,tdstelecom.com,ISP,US
109135,15557,Societe Francaise Du Radiotelephone SFR SA,gaoland.net,ISP,FR
29283,701,Verizon Business,verizonbusiness.com,ISP,US

3. File Relationship Diagram

The diagram below illustrates the relationships between the various files included in the CSV database package. It shows how the main CSV file connects to reference table for asn details, ensuring accurate data linkage and integrity.

File Format & Encoding

All IP to ASN (Lite) CSV datasets are provided in UTF-8 encoding, comma-separated, and compressed with Gzip (.csv.gz). Each file includes a header row listing the field names for clarity and consistency.

Field values are unquoted by default, with quotes applied only in the following cases:

Line breaks within text fields.
Commas inside a value (e.g., addresses).
Lists of values (e.g., languages).
Spaces that may be auto-quoted by export tools.

MMDB Database Documentation

1. Overview

MMDB version of the database consists of three files: one MMDB file containing all ASN information, a README file, and a checksum file, all compressed together in a ZIP file for easy delivery.

2. Archive Content

After downloading and extracting the IP to ASN (Lite) MMDB database archive, you'll find the following files (with their types noted):

db-ip-asn.mmdb

Provides full ASN details for IP addresses: organization, domain, type, and country.

File Size: 14.20 MB

Entries: 29.9M

README.md

Documentation for dataset contents, schema, usage, and support.

File Size: 4.55 KB

checksum.txt

SHA-256 checksums for verifying file integrity.

File Size: 157 Bytes

Response Schema

This section describes the structure of the data returned from the IP to ASN (Lite) MMDB file. Each field is detailed with its type, meaning, and example values to help you interpret responses and integrate them into your applications.

1. db-ip-asn.mmdb

This file contains Autonomous System Number (ASN) mappings for both IPv4 and IPv6 address ranges. Below is an example of the structure you will encounter in the response.

2. Field Reference

The following reference lists all fields available in the MMDB response. Each entry includes the field path, its description, data type, and example value to help you understand how to parse and integrate the data.

Showing 0 of 5

Select a field to view details

I. Example Records

Example

{
  "asn": {
    "as_number": "58369",
    "country_code": "ID",
    "domain": "fiber.net.id",
    "organization": "PT. Fiber Networks Indonesia",
    "type": "BUSINESS"
  }
}

Database Integrity & Authenticity Verification

There are two methods of verifying the integrity and authenticity of our Database:

1. Using the Signature File (Recommended)

IPGeolocation.io signs every database release to ensure its authenticity and integrity. This allows customers to verify that a downloaded IP to ASN (Lite) database file originates directly from IPGeolocation.io and has not been altered, corrupted, or tampered with during transfer or storage.

Each database update includes a corresponding signature file, generated using our private signing key. Customers can validate the database using the provided public verification key. To verify a database file, you need:

Database file (the downloaded archive)
Signature file (the matching signature for that archive)
Public key (public-key.pem)

These files are available via official IPGeolocation.io download endpoints and are also shared in database update notifications.

Tip

The public key may be provided as PEM-encoded text. Save it to a file named public-key.pem

Ensure OpenSSL is installed on your system. If not, install it using the following commands

On Linux, if openssl is not installed

sudo apt install openssl

Verify OpenSSL installation:

openssl version

To verify the database file, run the following command, replacing the placeholders with your actual file paths:

openssl dgst -sha256 -verify <path-to-public-key.pem> -signature <path-to-signature-file.sig> <path-to-database-file.zip>

Example output:

Verified OK

if verification FAILED do not use the file, re-download the database and signature from official IPGeolocation endpoints. If the issue persists, please contact our support team.

2. Using the Checksum File (Legacy)

Each database archive includes a checksum.txt file containing the SHA-256 checksums for the files packaged in the archive. You can use this file to validate that the extracted contents are complete and unchanged.

Note

Always verify downloaded files with the provided checksum before importing.

On Linux, if sha256sum is not installed, first run:

sudo apt-get install coreutils

Then check the archive files against the checksum file with:

sha256sum -c checksum.txt

Example output:

db-asn-details.csv.gz: OK
db-ip-asn.csv.gz: OK
README.md: OK

*your output may differ depending on the specific database archive you downloaded.

If a file's checksum does not match, FAILED will be shown instead of OK . If verification fails, first confirm that the download completed correctly; if the issue persists, please contact our support team.

Data Format & Constraints

All fields defined in the schema are always present in the IP to ASN (Lite) MMDB response.
Fields may contain empty strings (""), but never null, so null checks are not required.
Place names such as countries, states, districts, and cities are available in multiple translations.
All text values are encoded in UTF-8.
Field names and response structure remain stable across updates for backward compatibility.

Database Updates & Delivery

When you subscribe to our IP to ASN (Lite) database, we'll send you static download links. These links never change, so you can use them both for your initial download and for all future updates. You will receive:

Database Archive URL : downloads the latest release of your subscribed database (CSV, MMDB or requested formats).
Signature File URL : downloads the matching signature file for the latest release (used for authenticity verification).
Public Key URL : downloads the public verification key (used with the signature file).
Status Endpoint URL : returns the database's most recent update timestamp.

Our databases are refreshed daily and weekly, ensuring you always have access to the most current data. Each time your subscribed dataset is updated, you'll also receive an email notification so you don't miss a release.

For automated workflows, you can check our status endpoint to see the last update timestamp. When the date changes, simply re-fetch the archive using your static download URL to pull the latest version into your system.

IP ASN Database Lite

Overview

Available Database Formats

CSV Database Documentation

1. Overview

2. Archive Content

Schema

1. db-ip-asn.csv.gz

I. Example Records

2. db-asn-details.csv.gz

I. Example Records

3. File Relationship Diagram

File Format & Encoding

MMDB Database Documentation

1. Overview

2. Archive Content

Response Schema

1. db-ip-asn.mmdb

2. Field Reference

I. Example Records

Database Integrity & Authenticity Verification

1. Using the Signature File (Recommended)

2. Using the Checksum File (Legacy)

Data Format & Constraints

Database Updates & Delivery

Subscribe to Our Newsletter