---
title: "Get Queue"
method: GET
path: "/v1/queue"
tags: ["Queue"]
---

# Get Queue

`GET /v1/queue`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/queue`
- 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 scheduled posts grouped by day, optionally filtered by status. Requires a paid Premium or Lifetime plan.

GET /v1/queue returns the account's posting queue — the schedule entries for posts that are waiting to publish, and the ones that already have. Pass status to narrow to draft, scheduled or published. Each entry carries the scheduleId used by the cancel and reschedule routes.

This is the read you want for a calendar view or a 'what is going out this week' check, as distinct from GET /v1/posts, which lists the drafts themselves.

## Query parameters

- `status` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object[], required
    - `date` string, date, required
    - `entries` object[], required
      - `id` string, required
      - `time` string, required
      - `content` string, required
      - `status` string, required
      - `scheduledTimeUTC` string, date-time, required
      - `timezone` string, 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 the queue". 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)