Skip to main content
GET
List drafts
Free - does not consume credits

Query parameters

limit
number
Results per page. Default 50, max 50.
afterCursor
string
Pagination cursor from a previous response. Pass the nextCursor value to fetch the next page.

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Response

drafts
object[]
Array of draft objects, ordered by creation date (newest first).
drafts[].id
string
Unique draft ID.
drafts[].text
string
The draft tweet text.
drafts[].topic
string
Topic the tweet is about. Omitted if not set.
drafts[].goal
string
Optimization goal. Omitted if not set.
drafts[].createdAt
string
ISO 8601 creation timestamp.
drafts[].updatedAt
string
ISO 8601 last update timestamp.
hasMore
boolean
true if additional pages exist beyond this result set.
nextCursor
string
Pagination cursor. Pass as the afterCursor query parameter to fetch the next page. Present only when hasMore is true.
Related: Create Draft to save a new draft, Get Draft to fetch a specific draft, or Delete Draft to remove one.
Last modified on May 5, 2026