curl "https://kodostatus.com/api/v1/incidents?status=investigating&limit=10" \
-H "X-API-Key: your_api_key"
{
"incidents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Database connectivity issues",
"status": "investigating",
"severity": "major",
"started_at": "2026-01-15T10:30:00.000Z",
"resolved_at": null,
"created_at": "2026-01-15T10:30:00.000Z",
"services": [{ "id": "660e8400-e29b-41d4-a716-446655440000", "name": "API" }],
"updates": [
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"status": "investigating",
"message": "We are investigating reports of database issues",
"created_at": "2026-01-15T10:30:00.000Z"
}
]
}
]
}
Incidents
List Incidents
Get all incidents for your organization
GET
/
incidents
curl "https://kodostatus.com/api/v1/incidents?status=investigating&limit=10" \
-H "X-API-Key: your_api_key"
{
"incidents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Database connectivity issues",
"status": "investigating",
"severity": "major",
"started_at": "2026-01-15T10:30:00.000Z",
"resolved_at": null,
"created_at": "2026-01-15T10:30:00.000Z",
"services": [{ "id": "660e8400-e29b-41d4-a716-446655440000", "name": "API" }],
"updates": [
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"status": "investigating",
"message": "We are investigating reports of database issues",
"created_at": "2026-01-15T10:30:00.000Z"
}
]
}
]
}
Query Parameters
Filter by status:
investigating, identified, monitoring, resolvedMaximum number of incidents to return (max: 100)
Response
Show incident object
Show incident object
Unique incident identifier
Incident title
Current status:
investigating, identified, monitoring, resolvedSeverity level:
minor, major, criticalISO 8601 timestamp when incident started
ISO 8601 timestamp when resolved (null if ongoing)
Affected services
ISO 8601 timestamp when incident was created
curl "https://kodostatus.com/api/v1/incidents?status=investigating&limit=10" \
-H "X-API-Key: your_api_key"
{
"incidents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Database connectivity issues",
"status": "investigating",
"severity": "major",
"started_at": "2026-01-15T10:30:00.000Z",
"resolved_at": null,
"created_at": "2026-01-15T10:30:00.000Z",
"services": [{ "id": "660e8400-e29b-41d4-a716-446655440000", "name": "API" }],
"updates": [
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"status": "investigating",
"message": "We are investigating reports of database issues",
"created_at": "2026-01-15T10:30:00.000Z"
}
]
}
]
}
⌘I