Sugra NetAtlas

ASN resources by country

Changed on

When ?country={cc} is provided, returns the ASN + IPv4 + IPv6 resource counts allocated to that country. Replaces the legacy /bgp/country/{cc}/resources path per spec section 12.

get/api/v1/network/asn

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/network/asn
  • Auth: API key in header x-api-key

Query parameters

countrystring required

ISO 3166-1 alpha-2 country code.

limitinteger

Max items per resource list (asn/ipv4/ipv6) in this page.

offsetinteger

0-based offset into each resource list.

Response

Successful Response

countrystring nullable
asnsstring[] nullable
ipv4_prefixesstring[] nullable
ipv6_prefixesstring[] nullable

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"
  }
}

Changes

  • d2472ec2cf81Revision changes
    • info

      added the non-success response with the status

  • 560e8847c7b3Revision changes
    • breaking

      response property asns/anyOf[subschema #1]/items/ list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property ipv4_prefixes/anyOf[subschema #1]/items/ list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property ipv6_prefixes/anyOf[subschema #1]/items/ list-of-types was widened by adding types null to media type application/json of response 200