IP Security Database Documentation
Overview
Our IP Security Database helps detect malicious IPv4 and IPv6 addresses. This powerful IP threat intelligence database identifies high-risk IPs linked to spam, known attackers, open proxies, VPNs, relays, Tor exit nodes, bad bots, cloud providers, and corporate gateways.
Each IP record includes IP reputation data, threat categories, risk scores, proxy activity over the last 7 and 30 days, bot types, and gateway providers, giving you actionable insights for automated security workflows. Our intelligence is aggregated from multiple trusted sources worldwide, ensuring broad coverage of malicious infrastructure. Combined with IP Location data, this database makes it easy to correlate threats by region, detect patterns, and take proactive measures against evolving attacks.
Our threat intelligence is collected 24/7, so the latest signals always back your defenses, and security database updates are delivered on daily and weekly cycles depending on your subscription plan. The database is available in CSV and MMDB, with JSON, Parquet, or any custom format on request at no extra cost, backed by stable schemas and changelogs, for seamless integration with SIEMs, firewalls, fraud detection engines, and other cybersecurity platforms. Full documentation includes schema definitions, file specifications, and integration examples to help you deploy quickly and efficiently.
Available Database Formats
CSV Database Documentation
1. Overview
The CSV version of our IP to Security Database is delivered as a ZIP archive with a single Gzip-compressed CSV file that maps IPv4 and IPv6 ranges to security flags, threat scores, provider names, confidence scores, last-seen dates, and proxy activity counts. Use the schema below to import and interpret each column.
2. Archive Content
After downloading and extracting the IP to Security CSV database archive, you'll find the following files (with their types noted):
This Gzip-compressed CSV provides threat intelligence: IP ranges, threat scores, Tor/proxy flags, proxy activity counts, bot types, gateway flags, and more.
- File Size: 1.18 GB
- Entries: 74.3M
- Fields: 32
Documentation for dataset contents, schema, usage, and support.
- File Size: 6.40 KB
SHA-256 checksums for verifying file integrity.
- File Size: 164 Bytes
Schema
This section describes the schema of each file included in the IP to Security Database archive. For every file, you'll find its purpose, field definitions, and examples to help with integration.
1. db-ip-security.csv.gz
This file contains security threat data for IP address ranges. It maps each IP block to a threat_score and flags for specific security attributes, including Tor usage, proxy details and recent proxy activity (days seen in the last 7 and 30 days, and the number of providers listing it), bot type, and whether the IP is a known attacker, bot, cloud provider, or corporate gateway.
| 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 |
| threat_score | integer | The threat_score is a numerical value indicating the potential risk associated with the IP range, where a higher score suggests a greater risk. | No | 80 |
| is_tor | string | Indicates whether the IP range is associated with the Tor network. A value of true means the IP range is linked to a Tor exit node. | No | false |
| is_proxy | string | Indicates whether the IP range is associated with proxy activity. A value of true means the IP range is identified as a proxy. | No | true |
| proxy_provider_names | array | The name or names of proxy providers associated with the IP range, when available. | Yes | [Bright Data, Evomi Proxy] |
| proxy_confidence_score | integer | A numerical confidence score indicating how strongly the IP range is associated with proxy activity. A higher score means stronger confidence. | Yes | 95 |
| proxy_last_seen | string | The most recent date or timestamp when proxy activity was observed for the IP range. | Yes | 2026-03-15 |
| proxy_days_seen_7d | integer | Number of days in the last 7 days this IP was observed acting as a proxy. | No | 2 |
| proxy_days_seen_30d | integer | Number of days in the last 30 days this IP was observed acting as a proxy. | No | 9 |
| proxy_provider_count_30d | integer | Number of distinct proxy providers associated with this IP in the last 30 days. | No | 3 |
| is_residential_proxy | string | Indicates whether the IP range is associated with residential proxy activity. A value of true means the IP range is identified as a residential proxy. | No | false |
| is_vpn | string | Indicates whether the IP range is associated with VPN activity. A value of true means the IP range is identified as a VPN. | No | true |
| vpn_provider_names | array | The name or names of VPN providers associated with the IP range, when available. | Yes | [Nord VPN, Proton VPN] |
| vpn_confidence_score | integer | A numerical confidence score indicating how strongly the IP range is associated with VPN activity. A higher score means stronger confidence. | Yes | 90 |
| vpn_last_seen | string | The most recent date or timestamp when VPN activity was observed for the IP range. | Yes | 2026-03-12 |
| is_relay | string | Indicates whether the IP range is associated with relay network activity. A value of true means the IP range is identified as a relay service. | No | false |
| relay_provider_name | string | The name of the relay provider associated with the IP range, when available. | Yes | iCloud Private Relay |
| is_anonymous | string | Indicates whether the IP range is associated with anonymous browsing activity. A value of true means the IP range may be used to hide or mask a user's real network identity. | No | true |
| is_known_attacker | string | Indicates whether the IP range has been flagged as associated with known attackers or malicious activity. | No | true |
| is_bot | string | Indicates whether the IP range is associated with bot traffic. A value of true means the IP range is likely linked to automated traffic. | No | false |
| bot_confidence_score | integer | Confidence score from 0 to 100 indicating how likely the IP range is used for bot or automated traffic. A higher score means greater confidence. | No | 70 |
| bot_operator_name | string | The name of the organization that owns or operates the bot associated with the IP range, when identified. | Yes | Googlebot |
| bot_type | string | The classification of the bot associated with the IP range, such as search_engine, scraper and site_monitor. | Yes | search_engine |
| is_known_good_bot | string | Indicates whether the IP range belongs to a verified, well-behaved bot such as a search engine crawler. A value of true means the bot is a known good bot. | No | true |
| bot_last_seen | string | The most recent date on which the IP range was observed producing bot traffic, in YYYY-MM-DD format. | Yes | 2026-01-15 |
| is_spam | string | Indicates whether the IP range has been flagged for spam activity. A value of true means the IP range is associated with spam behavior. | No | false |
| is_cloud_provider | string | Indicates whether the IP range belongs to a cloud, hosting, or infrastructure provider. A value of true means the IP range is associated with cloud or hosting infrastructure. | No | true |
| cloud_provider_name | string | The name of the cloud, hosting, or infrastructure provider associated with the IP range, when available. | Yes | Amazon Web Services |
| is_corporate_gateway | string | Indicates whether the IP range is a corporate or enterprise egress gateway. A value of true means traffic from this range originates behind a corporate gateway. | No | false |
| corporate_gateway_type | string | The classification of the corporate gateway associated with the IP range, such as secure_web_gateway or browser_isolation. | Yes | browser_isolation |
| corporate_gateway_provider_name | string | The name of the corporate gateway provider or vendor associated with the IP range, when identified. | Yes | Zscaler |
I. Example Records
start_ip,end_ip,threat_score,is_tor,is_proxy,proxy_provider_names,proxy_confidence_score,proxy_last_seen,proxy_days_seen_7d,proxy_days_seen_30d,proxy_provider_count_30d,is_residential_proxy,is_vpn,vpn_provider_names,vpn_confidence_score,vpn_last_seen,is_relay,relay_provider_name,is_anonymous,is_known_attacker,is_bot,bot_confidence_score,bot_operator_name,bot_type,is_known_good_bot,bot_last_seen,is_spam,is_cloud_provider,cloud_provider_name,is_corporate_gateway,corporate_gateway_type,corporate_gateway_provider_name
85.251.139.200,85.251.139.200,45,false,true,[ThunderProxy],90,2026-10-28,0,1,1,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
104.6.82.44,104.6.82.44,45,false,true,"[Basil Proxies, Oxy Labs, Proxy-Seller, ProxyWing, Proxy-Cheap, Proxy-Store, Proxy4u, LightningProxies, SeamlessProxies, ByteProxies, SpyderProxy, ProxyScrape, FleetProxy, NodeMaven, Thordata, Geonix, Byteful, 2Captcha, DataImpulse, ProxyEmpire, Databay, Evomi Proxy, Ziny Proxy, InfiniteProxies]",99,2026-11-12,3,23,16,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
90.162.65.185,90.162.65.185,45,false,true,"[Kocerroxy, ThunderProxy]",99,2026-11-09,1,2,2,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
196.243.9.0,196.243.16.2,5,false,false,[],0,,0,0,0,false,false,[],0,,false,,false,false,false,0,,,false,,false,true,Fiber Grid INC,false,,
120.224.121.188,120.224.121.188,45,false,true,"[LightningProxies, ProxyEmpire, Proxy-Seller, SeamlessProxies, FleetProxy, ProxyWing]",99,2026-11-13,1,4,6,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
118.200.113.65,118.200.113.65,45,false,true,"[InfiniteProxies, Evomi Proxy, Byteful]",90,2026-10-31,0,5,3,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
78.208.0.16,78.208.0.16,45,false,true,[WebShare],90,2026-10-30,0,1,1,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
90.195.60.40,90.195.60.40,45,false,true,[Kocerroxy],90,2026-10-31,0,2,1,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
81.242.34.163,81.242.34.163,45,false,true,"[Kocerroxy, ThunderProxy]",90,2026-10-25,0,1,1,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
86.159.202.59,86.159.202.59,45,false,true,[SpyderProxy],90,2026-10-23,0,1,1,true,false,[],0,,false,,true,false,false,0,,,false,,false,false,,false,,
222.84.184.10,222.84.184.10,50,false,true,"[Proxy-Seller, SpyderProxy, Geonix, ProxyWing]",80,2026-09-12,0,0,0,true,false,[],0,,false,,true,false,false,0,,,false,,false,true,CHINANET,false,,2. File Relationship Diagram
File Format & Encoding
All IP to Security 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.
- Lists of values.
- Spaces that may be auto-quoted by export tools.
MMDB Database Documentation
1. Overview
The MMDB version of the database consists of three files: one MMDB file containing IP security data, 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 Security MMDB database archive, you'll find the following files (with their types noted):
Contains security details for IP addresses: VPN/proxy, proxy activity counts, Tor, attacker flags, bot types, corporate gateways, and cloud provider names.
- File Size: 12.99 GB
- Entries: 74.3M
Documentation for dataset contents, schema, usage, and support.
- File Size: 7.46 KB
SHA-256 checksums for verifying file integrity.
- File Size: 162 Bytes
Response Schema
This section describes the structure of the data returned from the IP to Security 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-security.mmdb
This file contains security details 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.
| Field | Type | Description | Example |
|---|---|---|---|
threat_score | integer | The threat_score is a numerical value indicating the potential risk associated with the IP range, where a higher score suggests a greater risk. | 80 |
is_tor | string | Indicates whether the IP range is associated with the Tor network. A value of true means the IP range is linked to a Tor exit node. | false |
is_proxy | string | Indicates whether the IP range is associated with proxy activity. A value of true means the IP range is identified as a proxy. | true |
proxy_provider_names | array | The name or names of proxy providers associated with the IP range, when available. | [Bright Data, Evomi Proxy] |
proxy_confidence_score | integer | A numerical confidence score indicating how strongly the IP range is associated with proxy activity. A higher score means stronger confidence. | 95 |
proxy_last_seen | string | The most recent date or timestamp when proxy activity was observed for the IP range. | 2026-03-15 |
proxy_days_seen_7d | integer | Number of days in the last 7 days this IP was observed acting as a proxy. | 2 |
proxy_days_seen_30d | integer | Number of days in the last 30 days this IP was observed acting as a proxy. | 9 |
proxy_provider_count_30d | integer | Number of distinct proxy providers associated with this IP in the last 30 days. | 3 |
is_residential_proxy | string | Indicates whether the IP range is associated with residential proxy activity. A value of true means the IP range is identified as a residential proxy. | false |
is_vpn | string | Indicates whether the IP range is associated with VPN activity. A value of true means the IP range is identified as a VPN. | true |
vpn_provider_names | array | The name or names of VPN providers associated with the IP range, when available. | [Nord VPN, Proton VPN] |
vpn_confidence_score | integer | A numerical confidence score indicating how strongly the IP range is associated with VPN activity. A higher score means stronger confidence. | 90 |
vpn_last_seen | string | The most recent date or timestamp when VPN activity was observed for the IP range. | 2026-03-12 |
is_relay | string | Indicates whether the IP range is associated with relay network activity. A value of true means the IP range is identified as a relay service. | false |
relay_provider_name | string | The name of the relay provider associated with the IP range, when available. | iCloud Private Relay |
is_anonymous | string | Indicates whether the IP range is associated with anonymous browsing activity. A value of true means the IP range may be used to hide or mask a user's real network identity. | true |
is_known_attacker | string | Indicates whether the IP range has been flagged as associated with known attackers or malicious activity. | true |
is_bot | string | Indicates whether the IP range is associated with bot traffic. A value of true means the IP range is likely linked to automated traffic. | false |
bot_confidence_score | integer | Confidence score from 0 to 100 indicating how likely the IP range is used for bot or automated traffic. A higher score means greater confidence. | 70 |
bot_operator_name | string | The name of the organization that owns or operates the bot associated with the IP range, when identified. | Googlebot |
bot_type | string | The classification of the bot associated with the IP range, such as search_engine, scraper and site_monitor. | search_engine |
is_known_good_bot | string | Indicates whether the IP range belongs to a verified, well-behaved bot such as a search engine crawler. A value of true means the bot is a known good bot. | true |
bot_last_seen | string | The most recent date on which the IP range was observed producing bot traffic, in YYYY-MM-DD format. | 2026-01-15 |
is_spam | string | Indicates whether the IP range has been flagged for spam activity. A value of true means the IP range is associated with spam behavior. | false |
is_cloud_provider | string | Indicates whether the IP range belongs to a cloud, hosting, or infrastructure provider. A value of true means the IP range is associated with cloud or hosting infrastructure. | true |
cloud_provider_name | string | The name of the cloud, hosting, or infrastructure provider associated with the IP range, when available. | Amazon Web Services |
is_corporate_gateway | string | Indicates whether the IP range is a corporate or enterprise egress gateway. A value of true means traffic from this range originates behind a corporate gateway. | false |
corporate_gateway_type | string | The classification of the corporate gateway associated with the IP range, such as secure_web_gateway or browser_isolation. | browser_isolation |
corporate_gateway_provider_name | string | The name of the corporate gateway provider or vendor associated with the IP range, when identified. | Zscaler |
2. Example Records
{
"bot_confidence_score": 0,
"bot_last_seen": "",
"bot_operator_name": "",
"bot_type": "",
"cloud_provider_name": "",
"corporate_gateway_provider_name": "",
"corporate_gateway_type": "",
"is_anonymous": "true",
"is_bot": "false",
"is_cloud_provider": "false",
"is_corporate_gateway": "false",
"is_known_attacker": "false",
"is_known_good_bot": "false",
"is_proxy": "true",
"is_relay": "false",
"is_residential_proxy": "true",
"is_spam": "false",
"is_tor": "false",
"is_vpn": "false",
"proxy_confidence_score": 90,
"proxy_days_seen_30d": 1,
"proxy_days_seen_7d": 0,
"proxy_last_seen": "2026-10-28",
"proxy_provider_count_30d": 1,
"proxy_provider_names": [
"ThunderProxy"
],
"relay_provider_name": "",
"threat_score": 45,
"vpn_confidence_score": 0,
"vpn_last_seen": "",
"vpn_provider_names": []
}Database Integrity & Authenticity Verification
There are two ways to verify the integrity and authenticity of our databases:
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 Security 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.
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.
Data Format & Constraints
- All fields defined in the schema are always present in the IP to Security 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 Security 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 updated continuously and shipped on a daily or weekly cycle depending on your plan. 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.
Snowflake Marketplace
This database is also available on Snowflake Marketplace as the IP Intelligence for Fraud & Security listing, so you can query it with SQL inside your Snowflake account, with no files to download. The listing page shows its columns, refresh schedule, and trial terms. See all our Snowflake Marketplace listings.