curl "https://kodostatus.com/api/v1/incidents?status=investigating&limit=10" \
-H "X-API-Key: your_api_key"
const response = await fetch(
'https://kodostatus.com/api/v1/incidents?status=investigating',
{
headers: { 'X-API-Key': process.env.KODO_API_KEY }
}
);
const data = await response.json();
{
"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"
const response = await fetch(
'https://kodostatus.com/api/v1/incidents?status=investigating',
{
headers: { 'X-API-Key': process.env.KODO_API_KEY }
}
);
const data = await response.json();
{
"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
string
Filter by status:
investigating, identified, monitoring, resolvedinteger
default:"50"
Maximum number of incidents to return (max: 100)
Response
array
Show incident object
Show incident object
string
Unique incident identifier
string
Incident title
string
Current status:
investigating, identified, monitoring, resolvedstring
Severity level:
minor, major, criticalstring
ISO 8601 timestamp when incident started
string
ISO 8601 timestamp when resolved (null if ongoing)
array
Affected services
string
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"
const response = await fetch(
'https://kodostatus.com/api/v1/incidents?status=investigating',
{
headers: { 'X-API-Key': process.env.KODO_API_KEY }
}
);
const data = await response.json();
{
"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