Bogon Ranges
free/v1/ip/bogon/rangesReturns the complete list of bogon IP ranges sourced from the IANA Special-Purpose Address Registries (RFC 6890, RFC 8190). Includes both IPv4 and IPv6 ranges with CIDR notation, classification, description, and RFC references. Use this to build local validation logic or generate firewall rules.
What It Does
Returns all IANA-defined special-purpose address ranges for both IPv4 (16 ranges) and IPv6 (12 ranges). Each entry includes CIDR notation, bogon type classification (private, loopback, link_local, multicast, documentation, carrier_grade_nat, benchmarking, reserved, broadcast, unspecified, unique_local), human-readable description, governing RFC reference, and IP version indicator. Data is sourced from RFC 6890 and RFC 8190.
Why It's Useful
Build or update local bogon filtering logic with authoritative, machine-readable range data. Essential for generating firewall ACLs, implementing client-side IP validation, and maintaining accurate ingress/egress filtering per BCP 38 (RFC 2827). Eliminates the need to manually track RFC updates to the IANA special-purpose registries.
Use Cases
Firewall Rule Generation
Programmatically generate iptables, pf, or cloud security group rules to block all bogon ranges at the network edge, following BCP 38 (RFC 2827) ingress filtering recommendations.
Comprehensive, up-to-date bogon blocking rules generated from authoritative IANA data.
Client-Side IP Validation Library
Cache the bogon range list locally to build high-performance IP validation in your application without per-request API calls, refreshing periodically.
Sub-millisecond local bogon validation with zero API latency, suitable for hot-path request processing.
Security Research & Documentation
Reference the complete, RFC-sourced bogon range list for security research papers, network architecture documentation, or compliance audit evidence.
Authoritative, structured reference data with full RFC provenance for documentation and research.
Parameters
| Name | Type | Required | Description |
|---|
Response Fields
| Field | Type | Description |
|---|---|---|
ranges | array | Complete list of bogon ranges with metadata |
ranges[].cidr | string | CIDR notation for the range (e.g., 10.0.0.0/8) |
ranges[].type | string | Bogon classification (private, loopback, multicast, etc.) |
ranges[].description | string | Human-readable description of the range purpose |
ranges[].rfc | string | Governing RFC reference (e.g., RFC 1918) |
ranges[].ip_version | number | IP version: 4 or 6 |
total_count | number | Total number of bogon ranges returned |
Code Examples
curl "https://api.edgedns.dev/v1/ip/bogon/ranges" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch(
'https://api.edgedns.dev/v1/ip/bogon/ranges',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/ip/bogon/ranges',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
}
)
data = response.json()
print(data)Read the full Bogon Ranges guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the Bogon Ranges endpoint live in the playground.