Incident statistics

Get aggregated incident statistics for your tenant.

GET /v1/analytics/incidents

Incident statistics

cURL

curl --request GET \
  --url https://api.example.com/v1/analytics/incidents

Overview

Returns aggregated incident statistics for the current tenant over a specified time period. Use this endpoint to track incident trends, resolution rates, and mean time to resolution (MTTR).

Required role: Any authenticated user

Query parameters

period · string

The time period to aggregate statistics over. One of: 7d, 30d, 90d. Defaults to 30d.

Response

Returns 200 OK with aggregated incident statistics.

{
  "totalIncidents": 47,
  "resolvedIncidents": 43,
  "mttr": 1800,
  "resolutionRate": 0.915,
  "bySeverity": {
    "critical": 3,
    "high": 12,
    "medium": 22,
    "low": 10
  }
}

Field	Type	Description
totalIncidents	integer	Total number of incidents created in the period
resolvedIncidents	integer	Number of incidents that reached resolved status in the period
mttr	integer	Mean time to resolution in seconds, averaged across all resolved incidents
resolutionRate	number	Proportion of incidents resolved: resolvedIncidents / totalIncidents (0 to 1)
bySeverity.critical	integer	Number of incidents with critical severity
bySeverity.high	integer	Number of incidents with high severity
bySeverity.medium	integer	Number of incidents with medium severity
bySeverity.low	integer	Number of incidents with low severity

Error responses

Status	Error code	Description
400	validation_error	The period parameter is not one of the allowed values

Examples

curl

# Default 30-day period
curl "https://api.causeflow.ai/v1/analytics/incidents" \
  -H "Authorization: Bearer <token>"

# Last 90 days
curl "https://api.causeflow.ai/v1/analytics/incidents?period=90d" \
  -H "Authorization: Bearer <token>"