{"openapi":"3.1.0","info":{"title":"ASN Lookup API","version":"1.0.0","description":"Look up Autonomous System Numbers (ASNs) — the identifiers that label every network on the public internet — mapped to their owning organisation and country. 122,000+ ASNs derived from the Regional Internet Registries (ARIN, RIPE, APNIC, LACNIC, AFRINIC). Resolve an ASN to its operator (e.g. AS15169 → Google LLC, US; AS13335 → Cloudflare; AS16509 → Amazon), or search by organisation name and country (e.g. \"hetzner\" in DE). Ideal for network intelligence, abuse/security investigation, traffic analysis, IP-reputation tooling and BGP/peering research.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/asn-api","description":"oanor gateway"}],"tags":[{"name":"ASN"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/asn":{"get":{"operationId":"get_v1_asn","tags":["ASN"],"summary":"A single ASN → organisation + country","description":"","parameters":[{"name":"asn","in":"query","required":true,"description":"ASN, e.g. 15169 (or AS15169)","schema":{"type":"string"},"example":"15169"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"asn":15169,"name":"Google LLC","handle":"GOOGLE","country":"US"},"meta":{"timestamp":"2026-05-31T05:47:59.447Z","request_id":"a1fa911b-3254-45eb-8899-187c511f6bd4"},"status":"ok","message":"ASN retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["ASN"],"summary":"Search ASNs by organisation name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Organisation name, e.g. cloudflare","schema":{"type":"string"},"example":"cloudflare"},{"name":"country","in":"query","required":false,"description":"2-letter country filter, e.g. DE","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"limit":20,"query":"cloudflare","total":12,"offset":0,"results":[{"asn":13335,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET-AS","country":"US"},{"asn":14789,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET","country":"US"},{"asn":132892,"name":"Cloudflare Inc.","handle":"CLOUDFLARE","country":"US"},{"asn":133877,"name":"Cloudflare Hong Kong LLC","handle":"CLOUDFLARE","country":"US"},{"asn":139242,"name":"Cloudflare Sydney LLC","handle":"CSL-AS-AP","country":"US"},{"asn":202623,"name":"Cloudflare Inc","handle":"CLOUDFLARENET-CORE","country":"US"},{"asn":203898,"name":"Cloudflare Inc","handle":"CLOUDFLARENET-UK","country":"US"},{"asn":209242,"name":"Cloudflare London LLC","handle":"CLOUDFLARESPECTRUM","country":"US"},{"asn":394536,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET-SFO","country":"US"},{"asn":395747,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET-SFO05","country":"US"},{"asn":400095,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET","country":"US"},{"asn":402542,"name":"Cloudflare Inc.","handle":"CLOUDFLARENET","country":"US"}]},"meta":{"timestamp":"2026-05-31T05:47:59.534Z","request_id":"4d83c84d-73ad-41a9-be0e-02001af7181c"},"status":"ok","message":"ASNs listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & top countries","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"An ASN identifies a network on the public internet. handle = RIR handle; country = registration country.","total":122788,"fields":["asn","name","handle","country"],"source":"ipverse/asn-info (Autonomous System Numbers, derived from the RIRs)","countries":240,"top_countries":[{"count":32728,"country":"US"},{"count":9284,"country":"BR"},{"count":6463,"country":"CN"},{"count":6133,"country":"IN"},{"count":5826,"country":"RU"},{"count":3897,"country":"ID"},{"count":3296,"country":"GB"},{"count":3283,"country":"DE"},{"count":3006,"country":"AU"},{"count":2528,"country":"CA"},{"count":2481,"country":"PL"},{"count":2211,"country":"FR"},{"count":2021,"country":"UA"},{"count":2003,"country":"BD"},{"count":1620,"country":"NL"}]},"meta":{"timestamp":"2026-05-31T05:47:59.604Z","request_id":"fb10be1f-d8df-4c6f-a0c5-5d6e68b0b9bd"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":350,"monthly_call_quota":110000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1000,"monthly_call_quota":550000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2700,"monthly_call_quota":2600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/asn-api"}