IP Range Info

What It Does

Parses and validates CIDR notation, then returns comprehensive range details: first/last IP addresses, total addresses in range, usable host count (excluding network and broadcast for IPv4), network and broadcast addresses, subnet mask, wildcard mask, associated ASN with organization name (populated for every allocated ASN via the Team Cymru AS-description fallback, not just a curated list), RIR allocation details, abuse contact (sourced via RDAP, including RIPE's `abuse-mailbox` vCard convention), the BGP-announced prefix, and the relationship between your queried CIDR and that announcement.

Why It's Useful

Essential for network planning, IP allowlist/blocklist management, and abuse handling. The `bgp_match` enum makes "my internal documentation says this is a /24 but it's actually announced as a /16" inspectable in one field. Understanding the scope and ownership of IP blocks prevents over-blocking in security rules, enables accurate capacity planning, and provides the right contacts for abuse reporting.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/ip/range" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "ip=8.8.8.0/24"

const response = await fetch(
  'https://api.edgedns.dev/v1/ip/range?ip=8.8.8.0%2F24',
  {
    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/range',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'ip': '8.8.8.0/24'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.