---
title: "List posts"
method: GET
path: "/v1/posts"
tags: ["Drafts"]
---

# List posts

`GET /v1/posts`

List posts for an account.

## Query parameters

- `account` integer, required
- `status` 'DRAFT' | 'SCHEDULED' | 'PUBLISHING' | 'PUBLISHED', nullable
- `tag_id` integer, nullable
- `page` integer
- `size` integer

## Response `200`

OK

- PagedDraftListResponse
  - `results` DraftListResponse[], required
    - `social_set_id` integer, required — ID of the social set (account) this draft belongs to
    - `share_url` string, nullable — Public share URL for the draft. Null if the draft is not publicly shared.
    - `private_url` string, required — Private URL for accessing the draft in Postey. Can be shared with team members without requiring public sharing.
    - `status` string, required — Current status of the draft. 'draft' = saved but not scheduled, 'scheduled' = queued for publishing, 'published' = successfully posted, 'publishing' = currently being posted, 'error' = publishing failed
    - `tags` string[] — List of tag slugs (not names) associated with this draft. Use the /tags endpoint to get available tags with their slugs.
    - `created_at` string, date-time, required — Timestamp when the draft was created (ISO 8601 format in UTC)
    - `updated_at` string, date-time, nullable, required — Timestamp when the draft was last edited (ISO 8601 format in UTC). Null if never edited.
    - `published_at` string, date-time, nullable, required — Timestamp when the draft was published on any enabled platform (ISO 8601 format in UTC). Null if not yet published anywhere.
    - `mastodon_post_published_at` string, date-time, nullable, required — Timestamp when the post was published to Mastodon (ISO 8601 format in UTC). Null if not published to Mastodon.
    - `linkedin_post_published_at` string, date-time, nullable, required — Timestamp when the post was published to LinkedIn (ISO 8601 format in UTC). Null if not published to LinkedIn.
    - `threads_post_published_at` string, date-time, nullable, required — Timestamp when the post was published to Threads (ISO 8601 format in UTC). Null if not published to Threads.
    - `bluesky_post_published_at` string, date-time, nullable, required — Timestamp when the post was published to Bluesky (ISO 8601 format in UTC). Null if not published to Bluesky.
    - `x_post_published_at` string, date-time, nullable — Timestamp when the post was published to X (ISO 8601 format in UTC). Null if not published to X.
    - `x_post_enabled` boolean, required — Whether posting to X is enabled for this draft
    - `linkedin_post_enabled` boolean, required — Whether posting to LinkedIn is enabled for this draft
    - `threads_post_enabled` boolean, required — Whether posting to Threads is enabled for this draft
    - `bluesky_post_enabled` boolean, required — Whether posting to Bluesky is enabled for this draft
    - `x_published_url` string, nullable — URL of the published post on X (Twitter). Null if not published to X or URL not available.
    - `linkedin_published_url` string, nullable — URL of the published post on LinkedIn. Null if not published to LinkedIn or URL not available.
    - `id` integer, nullable
    - `preview` string, nullable
    - `scheduled_date` string, date-time, nullable
    - `draft_title` string, nullable
    - `mastodon_post_enabled` boolean
  - `count` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next` string, nullable, required
  - `previous` string, nullable, required

## Other responses

- `403` — Insufficient permissions
- `404` — Resource not found
- `429` — Rate limited

---

[API](https://skmtc.dev/raycast/apis/postey-public-api.md) · [All operations](https://skmtc.dev/raycast/apis/postey-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/raycast/postey-public-api/revisions/65807802627f/schema)