ASN geographic distribution from Sugra NetAtlas
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 > peering-registry > 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: the atlas store 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).
Path parameters
Response
Successful Response
Example response
{
"_meta": {
"product": "Sugra NetAtlas",
"atlas_built_at": "2026-08-21T04:00:00Z",
"privacy_signal_version": "2026.06",
"confidence": "high",
"accuracy": "public",
"response_time": "2026-08-22T10:00:00Z"
}
}