asnzone
EN - English
Sign up →

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.

Interactive docsGet an API key →
// base url https://api.asn.zone/v1OpenAPI 3.1 · JSON-LD · llms.txt

Quickstart

no auth required for free tier
# High-level totals
curl https://api.asn.zone/v1/overview | jq
 
# Drill into Google
curl https://api.asn.zone/v1/asn/15169 | jq
 
# Per-IP geolocation with full delegation history
curl https://api.asn.zone/v1/ip/8.8.8.8/geo | jq
 
# Recent transfers, last 30 days, country US
curl "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.

openapi.jsonllms.txt
MethodPathWhat it doesTier
GET/v1/overviewHigh-level dataset totalsfree
GET/v1/asnsList ASNs, filterable by country and registryfree
GET/v1/asn/{id}Single ASN with org reference, country, peer/presence summariesfree
GET/v1/asn/{id}/peersProviders, peers, customers (CAIDA AS-Rank)free
GET/v1/asn/{id}/facilitiesPhysical facility presence (PeeringDB)free
GET/v1/asn/{id}/ixInternet Exchange membershipsfree
GET/v1/asn/{id}/prefixesAnnounced BGP prefixes for the ASN (CAIDA pfx2as)developer
GET/v1/org/{registry}/{id}Organization with name, address, contacts, holdingsfree
GET/v1/org/{registry}/{id}/timelineCombined allocation + transfer timelinedeveloper
GET/v1/countriesList countries with stats and 30-day deltasfree
GET/v1/country/{cc}Country detail with top organizations and recent ASNsfree
GET/v1/continentsContinent-level allocation totalsfree
GET/v1/transfersRecent transfer events across the RIR transfer logsfree
GET/v1/ip/{address}/ownerIP → registered holder, ASN, prefixfree
GET/v1/ip/{address}/geoMulti-source IP geolocation with cross-source consensusdeveloper
GET/v1/bgp/announcementsRecent BGP announcements (RouteViews / RIPE RIS)developer
GET/v1/bgp/byoipBring-Your-Own-IP prefixesdeveloper
GET/v1/searchSearch ASNs, organizations, prefixes, and countriesfree
GET/v1/health/sourcesPer-source freshness with 4-state status ladder (ok / degraded / stale / error)free
GET/v1/meCaller customer profile + per-day quota + remaining requestsfree
GET/v1/auditConsumer-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_...'
Create a key

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
Full source list →
Built for AI agents too
The site exposes llms.txt, JSON-LD on every page, and an indexed robots.txt that explicitly welcomes major AI and search crawlers. Build agents that read the public network record without scraping.
llms.txt →