---
title: "List Draft Tweets"
method: GET
path: "/draft/list"
tags: ["Write Actions"]
---

# List Draft Tweets

`GET /draft/list`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/draft/list`
- Auth: HTTP bearer

List every draft on the account behind your registered session. Each row carries the draft id, its text, and thread_truncated, which is true when the draft is a thread and the text you get is only its first tweet. Ordering is X's: pass ascending=true to ask for the oldest first, omit it for X's default. Billed at $0.0016 per call. Cost: $0.0016 per call.

## Query parameters

- `ascending` boolean: Pass true to ask X for the oldest draft first. Anything else, including omitting it, sends ascending=false, which is what X's own composer sends. The resulting order is X's and is not re-sorted here.
- `fields` string
- `compact` '1'

## Response `200`

List the drafts saved on your own account.

- object
  - `drafts` object[]: The drafts on this account. An empty array with no partial flag is an honest empty list.
    - `draft_tweet_id` string: Numeric ID of the draft. This is the id to pass to draft/edit and draft/delete.
    - `text` string, nullable: The draft body. Null when that row's text could not be read, which also sets partial on the response.
    - `thread_truncated` boolean: True when the draft is a THREAD and text is only its first tweet. The parse succeeded; the feature is narrower than the data. False for an ordinary single-tweet draft.
  - `count` integer: Number of rows in drafts.
  - `partial` boolean: Present and true only when the answer was read but not fully understood. ANY ONE of these sets it: a row was dropped, a row's text could not be read, a row's thread shape could not be read, or the envelope itself could not be read. ABSENT on a clean read, including a clean empty list, so an empty drafts array with no partial flag means you have no drafts rather than that we could not tell.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

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