---
title: "List draft post variants"
method: GET
path: "/drafts"
tags: ["Drafts"]
---

# List draft post variants

`GET /drafts`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/drafts`
- Auth: API key in header `Authorization`

Up to 50 most recent post variants in `draft` or `pending_review` status.

## Response `200`

Drafts.

- DraftsListResponse
  - `drafts` Draft[], required
    - `id` string, uuid
    - `platform` string
    - `caption` string
    - `hashtags` string[]
    - `tone` string
    - `status` 'draft' | 'pending_review' | 'approved' | 'rejected' | 'scheduled'
    - `source` string
    - `source_ref` string, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: Plan limit: no active plan (any write; `reason: "no_active_plan"`), a monthly allowance is spent, or the feature is not on the caller's plan. Detect by `code: "plan_limit_exceeded"`.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).

---

[API](https://skmtc.dev/misarpost/apis/misarpost-api.md) · [All operations](https://skmtc.dev/misarpost/apis/misarpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misarpost/apis/misarpost-api/revisions/deec26db1305?raw)