> ## 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 Design Versions

> List design versions in descending version order with cursor pagination

## Path Parameters

<ParamField path="id" type="string" required>
  Status page ID.
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer" default="20">
  Page size clamped to `1..100`.
</ParamField>

<ParamField query="cursor" type="integer">
  Return rows where `version_number < cursor`.
</ParamField>

## Response

<ResponseField name="versions" type="array">
  Compact version list with fields:
  `id`, `status_page_id`, `version_number`, `state`, `base_version_id`, `template_mode`, `summary`, `created_by`, `created_at`, `published_at`.

  Valid `state` values: `draft`, `published`, `archived`.
</ResponseField>

<ResponseField name="next_cursor" type="integer | null">
  Cursor for the next page.
</ResponseField>

<ResponseField name="current_version_id" type="string | null">
  Current published pointer.
</ResponseField>

<ResponseField name="draft_version_id" type="string | null">
  Current draft pointer.
</ResponseField>

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

<ResponseExample>
  ```json theme={null}
  {
    "versions": [
      {
        "id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
        "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
        "version_number": 4,
        "state": "published",
        "base_version_id": "2ca20538-6293-49a4-a7ba-7d38a16e4fd8",
        "template_mode": "default",
        "summary": "Brand refresh",
        "created_by": "api_key:abcd1234",
        "created_at": "2026-02-18T02:00:00.000Z",
        "published_at": "2026-02-18T02:02:00.000Z"
      }
    ],
    "next_cursor": null,
    "current_version_id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
    "draft_version_id": null
  }
  ```
</ResponseExample>