API referenceHealth
Incidents
Last updated
Fetch recent cross-subnet downtime incidents reconstructed from probe history over a 7d or 30d window (computed live from D1). Pair with /api/v1/health for the overall status summary.
Query Parameters
window?string
Value in
- "7d"
- "30d"
netuid?integer
Range
0 <= valuefields?string
Match
^[A-Za-z_][A-Za-z0-9_]*(,[A-Za-z_][A-Za-z0-9_]*)*$limit?integer
Range
1 <= value <= 1000cursor?integer
Range
0 <= valuesort?string
Field to sort by — the bare field name only (e.g. sort=total_stake_tao). Pair with the separate order parameter to choose direction; a combined field:desc token is NOT supported.
Value in
- "downtime_ms"
- "incident_count"
- "netuid"
- "surface_id"
order?unknown
Sort direction for sort: asc or desc (default desc). This is a separate parameter from sort — e.g. ?sort=emission_share&order=desc.
Value in
- "asc"
- "desc"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/incidents"{ "data": { "observed_at": "2026-06-01T00:00:00.000Z", "schema_version": 1, "source": "live-cron-prober", "summary": { "affected_surface_count": 1, "incident_count": 1 }, "surfaces": [ { "downtime_ms": 1, "incident_count": 1, "incidents": [ { "duration_ms": 1, "ended_at": 1, "failed_samples": 1, "started_at": 1 } ], "netuid": 7, "surface_id": "example" } ], "window": "30d" }, "meta": { "artifact_path": "example", "cache": "short", "contract_version": "2026-06-29.1", "generated_at": "2026-06-01T00:00:00.000Z", "pagination": { "collection": "example", "cursor": 1, "limit": 1, "next_cursor": 1, "order": "asc", "returned": 1, "sort": "example", "total": 1 }, "published_at": "2026-06-01T00:00:00.000Z", "source": "live-cron-prober", "stale_contract": { "built_under": "example", "live": "example" } }, "ok": true, "schema_version": 1}