> ## 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 Status Pages

> Get all status pages for your organization

<Info>
  This endpoint is API-key accessible.
</Info>

## Response

<ResponseField name="pages" type="array">
  <Expandable title="status page object">
    <ResponseField name="id" type="string">
      Unique status page identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      Status page name
    </ResponseField>

    <ResponseField name="slug" type="string">
      URL slug (used in `/status/{slug}`)
    </ResponseField>

    <ResponseField name="custom_domain" type="string">
      Custom domain if configured
    </ResponseField>

    <ResponseField name="logo_url" type="string">
      Logo image URL
    </ResponseField>

    <ResponseField name="primary_color" type="string">
      Brand color hex code
    </ResponseField>

    <ResponseField name="status_page_visibility" type="string">
      Visibility mode: `public`, `private`, `internal`
    </ResponseField>

    <ResponseField name="is_default" type="boolean">
      Whether this is the organization's default page
    </ResponseField>

    <ResponseField name="service_count" type="integer">
      Number of services assigned to this page
    </ResponseField>

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

    <ResponseField name="updated_at" type="string">
      ISO 8601 last update timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

<ResponseExample>
  ```json theme={null}
  {
    "pages": [
      {
        "id": "uuid",
        "name": "Public Status",
        "slug": "acme",
        "custom_domain": null,
        "logo_url": null,
        "primary_color": "#22c55e",
        "status_page_visibility": "public",
        "is_default": true,
        "service_count": 5,
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-06-15T12:00:00Z"
      },
      {
        "id": "uuid",
        "name": "Internal Ops",
        "slug": "acme-internal",
        "custom_domain": null,
        "logo_url": null,
        "primary_color": "#3b82f6",
        "status_page_visibility": "internal",
        "is_default": false,
        "service_count": 12,
        "created_at": "2024-06-01T00:00:00Z",
        "updated_at": "2024-06-15T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>