---
title: "List document drafts"
method: GET
path: "/api/v1/documents/{identifier}/drafts"
tags: ["Documents"]
---

# List document drafts

`GET /api/v1/documents/{identifier}/drafts`

Lists drafts for a document with branch context. By default only active drafts are returned; pass `include=archived` to also include soft-deleted drafts (retained ~7 days). Results are sorted by `createdAt` descending.

## Path parameters

- `identifier` string, required — Document identifier (either document ID or identifier slug)

## Query parameters

- `include` string — Comma-separated list of additional drafts to include. Only "archived" is recognized — when present, soft-deleted drafts (retained ~7 days) are returned alongside active drafts.

## Response `200`

List of drafts for the document

- ApiDraft[]
  - `branch` ApiDraftBranch, nullable, required — Branch the draft is attached to, or null for a draft on main
    - `id` string, uuid, required — Branch (omni model) ID
    - `name` string, required — Branch name
  - `createdAt` string, date-time, required — When the draft was created
  - `createdBy` ApiDraftActor, required — User who created the draft
    - `name` string, required — Display name
  - `draftOutOfDate` boolean, required — True when the published document was published more recently than the draft was created (the draft is based on a stale baseline)
  - `identifier` string, required — Draft workbook identifier — use this to address the draft
  - `lastEditedBy` object, required — User who most recently edited the draft
    - `name` string, required — Display name
  - `publishedIdentifier` string, required — Identifier of the published document the draft is for
  - `status` 'active' | 'archived', required — Lifecycle status: "active" for current drafts, "archived" for soft-deleted drafts (retained ~7 days)
  - `updatedAt` string, date-time, required — Most recent edit time on the draft workbook
  - `workbookModelId` string, uuid, required — omni_model ID for the draft workbook

## Other responses

- `400` — Invalid query parameters
- `401` — Authentication required
- `403` — Insufficient permissions to view the document
- `404` — Document not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)