> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodostatus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Incidents

> Get all incidents for your organization

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `investigating`, `identified`, `monitoring`, `resolved`
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Maximum number of incidents to return (max: 100)
</ParamField>

## Response

<ResponseField name="incidents" type="array">
  <Expandable title="incident object">
    <ResponseField name="id" type="string">
      Unique incident identifier
    </ResponseField>

    <ResponseField name="title" type="string">
      Incident title
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `investigating`, `identified`, `monitoring`, `resolved`
    </ResponseField>

    <ResponseField name="severity" type="string">
      Severity level: `minor`, `major`, `critical`
    </ResponseField>

    <ResponseField name="started_at" type="string">
      ISO 8601 timestamp when incident started
    </ResponseField>

    <ResponseField name="resolved_at" type="string">
      ISO 8601 timestamp when resolved (null if ongoing)
    </ResponseField>

    <ResponseField name="services" type="array">
      Affected services
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when incident was created
    </ResponseField>

    <ResponseField name="updates" type="array">
      <Expandable title="update object">
        <ResponseField name="id" type="string">
          Update ID
        </ResponseField>

        <ResponseField name="status" type="string">
          Status at time of update
        </ResponseField>

        <ResponseField name="message" type="string">
          Update message
        </ResponseField>

        <ResponseField name="created_at" type="string">
          ISO 8601 timestamp
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/incidents?status=investigating&limit=10" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript Node.js theme={null}
  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();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>