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

# Get Design State

> Get current and draft design pointers with hydrated design versions

## Path Parameters

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

## Response

<ResponseField name="status_page_id" type="string">
  Status page ID.
</ResponseField>

<ResponseField name="current_version_id" type="string | null">
  Published design version ID.
</ResponseField>

<ResponseField name="draft_version_id" type="string | null">
  Draft design version ID.
</ResponseField>

<ResponseField name="current_version" type="object | null">
  Published design version object.
</ResponseField>

<ResponseField name="draft_version" type="object | null">
  Draft design version object.
</ResponseField>

<ResponseField name="effective_design" type="object | null">
  What is effectively rendered (`current_version` fallback `draft_version`).
</ResponseField>

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

<ResponseExample>
  ```json theme={null}
  {
    "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
    "current_version_id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
    "draft_version_id": null,
    "current_version": {
      "id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
      "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
      "version_number": 4,
      "state": "published",
      "base_version_id": null,
      "theme_tokens": {
        "brand": { "primary": "#0ea5e9", "secondary": "#22c55e" },
        "font": { "family": "inter" }
      },
      "layout": {
        "sections": [
          { "type": "header", "enabled": true },
          { "type": "overall_status", "enabled": true },
          { "type": "services_list", "enabled": true }
        ]
      },
      "template": null,
      "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"
    },
    "draft_version": null,
    "effective_design": {
      "id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
      "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
      "version_number": 4,
      "state": "published",
      "base_version_id": null,
      "theme_tokens": {
        "brand": { "primary": "#0ea5e9", "secondary": "#22c55e" },
        "font": { "family": "inter" }
      },
      "layout": {
        "sections": [
          { "type": "header", "enabled": true },
          { "type": "overall_status", "enabled": true },
          { "type": "services_list", "enabled": true }
        ]
      },
      "template": null,
      "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"
    }
  }
  ```
</ResponseExample>

## Common Errors

| Status | Code | Meaning               |
| ------ | ---- | --------------------- |
| `404`  | -    | Status page not found |