---
title: "List drafts"
method: GET
path: "/v1/inboxes/{id}/drafts"
tags: ["Drafts"]
---

# List drafts

`GET /v1/inboxes/{id}/drafts`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/inboxes/{id}/drafts`
- Auth: API key in header `X-API-Key`

`scheduled=true` lists only drafts waiting to be sent, soonest first. A failed scheduled send shows `sendError`.

## Query parameters

- `limit` integer
- `offset` integer
- `scheduled` boolean

## Response `200`

OK

- object
  - `drafts` Draft[]
    - `id` string, uuid
    - `inboxId` string, uuid
    - `to` string[]
    - `cc` string[]
    - `bcc` string[]
    - `subject` string
    - `plainBody` string, nullable
    - `htmlBody` string, nullable
    - `replyToMessageId` string, uuid, nullable
    - `labels` string[]: Applied to the message when the draft is sent.
    - `sendAt` string, date-time, nullable: When Anjal will send this draft. Null if not scheduled.
    - `sendError` string, nullable: Why the last scheduled send failed. The draft is kept and `sendAt` is cleared.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

---

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