ASN geographic distribution from Sugra NetAtlas

GET

/api/v1/network/asn/{asn}/geo-distribution

Last modified:2026-07-19 17:02:27

Maintainer:Not configured

OperationId:network_asn_asn_geo_distribution

Derive country distribution by iterating atlas records for prefixes
matching the given ASN.

Semantic note (SNT-P1-10.1, post 2026-05-25): The hq_country and
top_countries fields reflect actual usage country (Geofeed >
cloud-region > PeeringDB > RIR allocation priority chain), NOT the
RIR allocation country alone. For globally-distributed ASNs (cloud
providers, CDNs), the distribution now spreads across the regions
where prefixes are actually announced (e.g., AWS AS16509 splits
across us-east-1=US, eu-west-1=IE, ap-northeast-1=JP, etc.) rather
than collapsing to a single RIR-alloc country. For traditional ISPs
the distribution is usually unchanged because they announce from
the same country their RIR allocated to. hq_country is the
dominant (most-common) actual-usage country, not necessarily the
legal headquarters - the name predates the SNT-P1-10 semantic clarification.

Implementation note: maxminddb does not provide a reverse index
(ASN -> prefixes), so we walk the database. For top ASNs (most
prefixes) this is O(N) in the atlas size (~1 M entries). v1.2-A
caches the response keyed by (asn, atlas_etag) so subsequent
hits within the same atlas build bypass the full walk; the cache
invalidates automatically when the atlas blob ETag rotates (daily
rebuild).

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

null

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

Modified at 2026-07-19 17:02:27

ASN abuse contact + RIR

ASN resources by country