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

# List Drafts

`GET /v1/posts`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/posts`
- Auth: one of:
  - OAuth 2 (client credentials, token URL `https://api.linkedmash.com/auth/oauth/token`, scopes: `content:read`)
  - HTTP bearer
  - API key in header `linkedmash-api-key`

List your post drafts, optionally filtered by status. Requires a paid Premium or Lifetime plan.

GET /v1/posts lists the account's post drafts. With no query string you get everything the Studio holds; pass status to narrow to draft, scheduled or published. The response is a flat array in data with meta.count alongside it.

Use this to reconcile an external content calendar with LinkedMash, or to find the draft ids you need for the schedule and update endpoints when you did not keep them from the create call.

## Query parameters

- `status` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object[], required
    - `id` string, required
    - `content` string, required
    - `title` string, required
    - `format` string, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `meta` object, required
    - `count` integer, required

## Other responses

- `401`: Unauthorized. The Authorization header is missing or the key is not a valid LinkedMash API key. Create or rotate keys on the API page in your LinkedMash settings.
- `402`: Payment Required. Returned with code SUBSCRIPTION_REQUIRED. The content API requires a Premium or Lifetime plan; Reader and free accounts get this on every /v1/posts, /v1/queue, /v1/schedule, /v1/media and /v1/analytics call.
- `500`: Server Error. Something failed on our side. The body carries message "Failed to list posts". Retry once; if it persists the request is not the problem.

---

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