subnethistory docs
Open the appApp
API reference/Utility endpoints

Utility endpoints

Sources, tags, recent searches, your own IP and the health check.

Small endpoints that support the main lookup surface.

Sources

endpoint
GET /api/v1/sources

The data sources SubnetHistory credits, machine readable. See Data sources for the story behind them.

response
{
  "sources": [
    {
      "id": "ripestat",
      "label": "RIPEstat",
      "homepage": "https://stat.ripe.net/",
      "attribution": "Routing and registry history via RIPE NCC RIPEstat",
      "capabilities": ["ip", "prefix", "asn"]
    }
  ]
}

capabilities lists which query kinds the source can answer for: ip, prefix, asn.

Tags

endpoint
GET /api/v1/tags

The full tag vocabulary, as documented in Tags and labels. Each tag carries id, slug, label, category, severity, color and description.

Recent searches

endpoint
GET /api/v1/recent

The twelve most recent searches across the site: the normalised query, its kind and when it happened. Nothing about who searched is included.

response
{
  "recent": [
    { "query": "AS13335", "kind": "asn", "at": "2026-08-09T04:58:21.000Z" }
  ]
}

Who am I

endpoint
GET /api/v1/whoami

Returns the IP address your request arrived from, so a client can offer a look up my own address button.

response
{ "ip": "203.0.113.7" }

Health

endpoint
GET /healthz

Liveness check. Note the path: it is at the site root, not under /api/v1, and it is exempt from rate limiting.

response
{ "status": "ok", "uptimeSec": 86400 }
Last updated 2026-08-09subnethistory.com