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

# Get Posting Slots

`GET /v1/queue/slots`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/queue/slots`
- 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`

Get the next available posting slots from your schedule. Requires a paid Premium or Lifetime plan.

GET /v1/queue/slots computes the next free posting times from the account's recurring schedule grid and returns them as concrete timestamps. count controls how many to return, and timezone is the IANA zone the times are expressed in.

It is the endpoint to call before scheduling if you want to show a user their options, or to pick a specific slot rather than letting POST /v1/posts/{id}/schedule resolve 'next-slot' for you.

## Query parameters

- `count` integer
- `timezone` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object[], required
    - `day` string, required
    - `time` string, required
    - `date` string, date, required
    - `displayDate` 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 fetch posting slots". 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)