Incidents

List incidents (all vendors)

Canonical path: prefer GET /incidents (this -unified URL is the legacy name; same handler).

Returns incidents across every vendor in one request. Filter with timePeriod, activeOnly, or vendor. For one vendor only, GET /vendors/{vendor}/incidents is often simpler.

When to use: polling all vendors every 60-120s. For live updates, use GET /incidents/stream (SSE).

get/api/v1/infrastructure/incidents-unified

Request

  • Base URL: https://www.huntertech.io
  • URL: https://www.huntertech.io/api/v1/infrastructure/incidents-unified
  • Auth: API key in header X-API-Key

Query parameters

timePeriodstring
Example:30d

History window (e.g. 7d, 30d, 90d). Capped by your plan data window (Standard: 30d, Pro: 90d, Enterprise: unlimited).

activeOnlyboolean

When true, return only ongoing (unresolved) incidents.

limitinteger

Maximum number of records to return.

vendorstring
Example:zscaler,cloudflare

Filter to one or more vendor slugs (comma-separated). Alias: vendors.

skipCacheboolean

When true, bypass server-side cache and fetch fresh data (debugging only).

Response

Success

successboolean required
itemsobject[] required

Incident, maintenance, advisory, or update records

totalinteger
fetchedAtstring date-time
sourcestring
lastUpdatedstring date-time

Example response

{
  "success": true,
  "total": 42,
  "source": "local-data"
}

Changes

No recorded changes to this operation across all 1 revision of this API.