> ## 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 Services

> Get all services for your organization

## Response

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

    <ResponseField name="name" type="string">
      Service name
    </ResponseField>

    <ResponseField name="description" type="string">
      Service description
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `operational`, `degraded`, `partial_outage`, `major_outage`, `maintenance`
    </ResponseField>

    <ResponseField name="display_order" type="integer">
      Order in which service appears on status page
    </ResponseField>

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

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/services" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://kodostatus.com/api/v1/services', {
    headers: { 'X-API-Key': process.env.KODO_API_KEY }
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "services": [
      {
        "id": "uuid",
        "name": "API Gateway",
        "description": "Main API service",
        "status": "operational",
        "display_order": 1,
        "created_at": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>