Sugra NetAtlas

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

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}

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

{"stackTrail":"components:schemas:NetworkGeofeedResourceData:properties:geoloc:anyOf","oasType":"schema","type":"unknown","title":"Geoloc","nullable":true}

{"stackTrail":"components:schemas:NetworkGeofeedResourceData:properties:geofeed_url:anyOf","oasType":"schema","type":"unknown","title":"Geofeed Url","nullable":true}

{"stackTrail":"components:schemas:NetworkGeofeedResourceData:properties:language:anyOf","oasType":"schema","type":"unknown","title":"Language","nullable":true}

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

Changed in 2 of the 21 revisions of this API.122

Aug 22, 2026914af3d38c7c110See the full diff
- ▲
  the response's body type/format changed from / to object/ for status 200
  response-body-type-changed
- ○
  added the optional property _meta to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property country to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property covering_inetnum to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property geofeed_url to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property geoloc to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property language to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property note to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property query to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property resource to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property source to the response with the 200 status
  response-optional-property-added
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history