Sugra NetAtlas

Operator self-published geolocation for an IP/prefix (RIPE DB geoloc/geofeed)

Changed on

Operator self-declared geolocation for an IP or prefix, read from the covering inet[6]num in the RIPE Database: country, geoloc (lat/lon, RFC 9092), the geofeed URL (RFC 8805 pointer), and language. This is first-party operator data - higher trust than a GeoIP guess where it exists, but self-declared and unverified. Picks the most-specific covering object that carries a geo signal. The geofeed URL is returned for client-side resolution; the server does not fetch it (the URL is operator-controlled - an SSRF surface). Upstream registry: 'global' (all RIRs via GRS, default) | ripe | ripe-nonauth | <rir>-grs.

get/api/v1/network/geofeed/{resource}

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/network/geofeed/{resource}
  • Auth: API key in header x-api-key

Path parameters

resourcestring required

IPv4/IPv6 address or CIDR prefix.

Query parameters

sourcestring

Upstream registry: 'global' (all RIRs via GRS, default) | ripe | ripe-nonauth | <rir>-grs.

Response

Successful Response

resourcestring nullable
querystring nullable
covering_inetnumstring nullable
countrystring nullable
geolocunknown
geofeed_urlunknown
languageunknown
sourcestring nullable
notestring 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

  • 914af3d38c7cRevision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status