API · v1
One JSON API.
Every page on this site, plus more.
Free tier with generous limits today; paid tiers unlock historical depth, transfer events, BGP stream, geo confidence, and bulk export. OpenAPI 3.1, JSON-LD, and llms.txt all served.
Quickstart
no auth required for free tier# High-level totalscurl https://api.asn.zone/v1/overview | jq# Drill into Googlecurl https://api.asn.zone/v1/asn/15169 | jq# Per-IP geolocation with full delegation historycurl https://api.asn.zone/v1/ip/8.8.8.8/geo | jq# Recent transfers, last 30 days, country UScurl "https://api.asn.zone/v1/transfers?to_country=US&days=30" | jq
Free tier
60 req/min, 1k req/day. No API key needed. Authenticate with a key for higher limits and access to developer+ endpoints.
Data freshness
RIR delegated stats and transfer logs sync daily; CAIDA + IPXO Geolocation monthly. Every response carries a Last-Modified header.
Endpoints
Detail + listing endpoints across every public surface. Tier indicates the lowest plan with access. Full reference in the OpenAPI doc.
| Method | Path | What it does | Tier |
|---|---|---|---|
| GET | /v1/overview | High-level dataset totals | free |
| GET | /v1/asns | List ASNs, filterable by country and registry | free |
| GET | /v1/asn/{id} | Single ASN with org reference, country, peer/presence summaries | free |
| GET | /v1/asn/{id}/peers | Providers, peers, customers (CAIDA AS-Rank) | free |
| GET | /v1/asn/{id}/facilities | Physical facility presence (PeeringDB) | free |
| GET | /v1/asn/{id}/ix | Internet Exchange memberships | free |
| GET | /v1/asn/{id}/prefixes | Announced BGP prefixes for the ASN (CAIDA pfx2as) | developer |
| GET | /v1/org/{registry}/{id} | Organization with name, address, contacts, holdings | free |
| GET | /v1/org/{registry}/{id}/timeline | Combined allocation + transfer timeline | developer |
| GET | /v1/countries | List countries with stats and 30-day deltas | free |
| GET | /v1/country/{cc} | Country detail with top organizations and recent ASNs | free |
| GET | /v1/continents | Continent-level allocation totals | free |
| GET | /v1/transfers | Recent transfer events across the RIR transfer logs | free |
| GET | /v1/ip/{address}/owner | IP → registered holder, ASN, prefix | free |
| GET | /v1/ip/{address}/geo | Multi-source IP geolocation with cross-source consensus | developer |
| GET | /v1/bgp/announcements | Recent BGP announcements (RouteViews / RIPE RIS) | developer |
| GET | /v1/bgp/byoip | Bring-Your-Own-IP prefixes | developer |
| GET | /v1/search | Search ASNs, organizations, prefixes, and countries | free |
| GET | /v1/health/sources | Per-source freshness with 4-state status ladder (ok / degraded / stale / error) | free |
| GET | /v1/me | Caller customer profile + per-day quota + remaining requests | free |
| GET | /v1/audit | Consumer-facing audit feed (org renames, tag changes, transfers added) | free |
Bulk download
Every dataset as NDJSON. Snake_case keys, contract-locked under v1.1. Pass ?since=<ISO> for incremental fetch; HEAD + If-Modified-Since short-circuits to 304 on no-change days. Errors return application/problem+json (RFC 7807).
- /v1/datasets/asns.jsonl
- /v1/datasets/organizations.jsonl
- /v1/datasets/ipv4-blocks.jsonl
- /v1/datasets/ipv6-blocks.jsonl
- /v1/datasets/transfers.jsonl
- /v1/datasets/asn-prefixes.jsonl
- /v1/datasets/bgp-byoip.jsonl
- /v1/datasets/manifest
TypeScript SDK
@asn-zone/sdk ships AsyncIterable streaming helpers over every bulk dataset endpoint plus the audit feed. Codegen from OpenAPI 3 Zod schemas; RFC 7807 errors parsed into a typed exception class; 429 retry-once respecting Retry-After.
// Stream the latest day of IPv4 allocations for await (const row of streamIpv4Blocks({ bearer, since: yesterday })) { console.log(row.org_id) }
Authentication
The free tier needs no key - open, rate-limited per IP. For higher limits and developer+ endpoints, sign up for a key and pass it as a Bearer header.
curl https://api.asn.zone/v1/asn/15169 \ -H 'Authorization: Bearer azk_live_...'
Data sources
Every datapoint is traceable. Full source list with refresh cadences on the about page.
- RIR delegated statsARIN · RIPE · APNIC · AFRINIC · LACNICdaily
- RIR transfer logsARIN · RIPE · APNICdaily
- CAIDA AS-Rank + AS-Organizationsasrank.caida.orgmonthly
- PeeringDBfac · ix · netixlandaily
- IPXO GeolocationIPv4 / IPv6 → citymonthly