---
title: "List drafts in an inbox"
method: GET
path: "/email_inboxes/{inbox_id}/drafts"
tags: ["Email Drafts"]
---

# List drafts in an inbox

`GET /email_inboxes/{inbox_id}/drafts`

Lists drafts newest first using stable cursor pagination. All access is scoped
to the authenticated account and the given inbox.

## Path parameters

- `inbox_id` string, uuid, required

## Query parameters

- `filter[status]` 'draft' | 'sending' | 'sent'
- `page[size]` integer
- `page[after]` string

## Response `200`

Paginated drafts.

- EmailDraftListResponse
  - `data` EmailDraft[], required
    - `record_type` 'email_draft', required
    - `id` string, uuid, required
    - `inbox_id` string, uuid, required
    - `status` 'draft' | 'sending' | 'sent', required — `draft` until the draft is sent. A sent draft is retained for audit and becomes immutable.
    - `from` string, nullable — Sender address. Defaults to the inbox address at send time when null.
    - `from_name` string, nullable
    - `to` EmailAddress[]
      - `email` string, required
      - `name` string
    - `cc` EmailAddress[]
      - `email` string, required
      - `name` string
    - `bcc` EmailAddress[]
      - `email` string, required
      - `name` string
    - `reply_to` string, nullable
    - `subject` string, nullable
    - `text_body` string, nullable
    - `html_body` string, nullable
    - `headers` object — Custom headers. Reply drafts carry `In-Reply-To` and `References`.
    - `attachments` object[]
    - `labels` string[] — Mutable mailbox-state labels. Not propagated to Email Detail Records.
    - `tags` string[] — Transport/reporting attribution tags, propagated to Email Detail Records at send time.
    - `metadata` object — Arbitrary customer-defined metadata.
    - `reply_to_message_id` string, uuid, nullable — Inbound message this draft replies to. Server-owned; set only on reply drafts.
    - `thread_id` string, uuid, nullable — Conversation thread inherited from the parent message.
    - `sent_message_id` string, uuid, nullable — The email message created when this draft was sent.
    - `sent_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` EmailPaginationMeta, required
    - `page_size` integer, required
    - `page_cursor` string — Cursor for the next page, when more results are available.

## Other responses

- `401` — Not authorized (10006).
- `404` — Resource not found (10001).
- `503` — Drafts or the email domain service are temporarily unavailable (10016).

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)