Return incidents

GET /api/v1/public/incidents

Returns incidents for the account the API key belongs to, newest first (ordered by creation date, descending). This is the only paginated endpoint, and it accepts no filter or sort parameters.

operationId Return incidents

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
`page`	integer	opcional	1-based page number.
`limit`	integer	opcional	Page size. A value above 200 is reduced to 200 rather than rejected.

Respuestas

200 A page of incidents, with page counters alongside.

Encabezados de respuesta

Nombre	Tipo	Descripción
`X-RateLimit-Limit`	integer	Your hourly allowance.
`X-RateLimit-Remaining`	integer	Requests left in the current window.
`X-RateLimit-Reset`	integer	When the window resets, as an absolute Unix epoch time in seconds — not a countdown.

Cuerpo de application/json

Campo	Tipo	Obligatorio	Descripción
`error`	boolean	obligatorio	Always `false` on a successful response. Authentication and rate-limit failures instead return a string error code in this field.
`data`	object	obligatorio	Payload wrapper. Note the nested `data` — this endpoint is the only one whose payload is an object rather than a bare array.
`data`	array	obligatorio	The incidents on this page.
`id`	string (uuid)	obligatorio	Incident identifier.
`incident_number`	string	obligatorio	Human-readable reference, e.g. `INC-2026-0001`.
`description`	string	opcional	Incident description.
`status`	string	obligatorio	Workflow status, e.g. `open`.
`severity_score`	integer	opcional	Calculated severity — `severity_likelihood` × `severity_impact`.
`severity_likelihood`	integer	opcional	Likelihood rating.
`severity_impact`	integer	opcional	Impact rating.
`location`	string	opcional	Location name.
`incident_date`	string (date)	opcional	Date the incident occurred.
`created_at`	string (date-time)	obligatorio	When the incident was created.
`updated_at`	string (date-time)	obligatorio	When the incident was last updated.
`pagination`	object	obligatorio	Page counters.
`page`	integer	obligatorio	Current page number.
`limit`	integer	obligatorio	Page size in effect.
`total`	integer	obligatorio	Total incidents in the account.
`pages`	integer	obligatorio	Total pages at the current `limit`.

Ejemplo

{
  "error": false,
  "data": {
    "data": [
      {
        "id": "3f1c…",
        "incident_number": "INC-2026-0001",
        "description": "Spill in loading bay 3",
        "status": "open",
        "severity_score": 12,
        "severity_likelihood": 3,
        "severity_impact": 4,
        "location": "Plant A",
        "incident_date": "2026-08-01",
        "created_at": "2026-08-01T10:00:00.000Z",
        "updated_at": "2026-08-02T09:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 137,
      "pages": 3
    }
  }
}

401 `API_KEY_REQUIRED` — the `Authorization: Bearer kcs_…` header is missing or malformed. `API_KEY_INVALID` — the key is unknown, revoked, or expired.

403 `INSUFFICIENT_SCOPE` — the key's scope does not permit this method. `FEATURE_NOT_AVAILABLE` — the account's plan does not include API access.

429 `RATE_LIMIT_EXCEEDED` — the hourly limit was reached. Read `Retry-After` (seconds); `X-RateLimit-Reset` is not set on a 429.

Encabezados de respuesta

Nombre	Tipo	Descripción
`Retry-After`	integer	Seconds to wait before retrying.

500 Unexpected server error.