---
title: "Get queue"
method: GET
path: "/api/post_queues/{id}"
tags: ["Queues"]
---

# Get queue

`GET /api/post_queues/{id}`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/post_queues/{id}`
- Auth: HTTP bearer

Retrieves a single queue by its ID, including its weekly timeslot definitions.

## Path parameters

- `id` string, required

## Query parameters

- `profile_group_id` string

## Response `200`

The queue

- Queue: A posting queue that automatically schedules posts into recurring weekly timeslots, with priority-based ordering.
  - `id` string: Queue identifier (ID)
  - `name` string: Queue name
  - `description` string, nullable: Optional description
  - `timezone` string: IANA timezone name (e.g. America/New_York)
  - `enabled` boolean: Whether the queue is active. When paused (false), posts in the queue will not be published even if their scheduled time arrives
  - `jitter` integer: Random offset in minutes (+/-) applied to scheduled times (0-60, default: 0)
  - `profile_group_id` string: Associated profile group (ID)
  - `timeslots` QueueTimeslot[]: Weekly timeslot definitions
    - `id` integer: Timeslot ID (used for deletion)
    - `day` integer: Day of the week: 0=Sunday, 1=Monday, ..., 6=Saturday
    - `time` string: Time in 24-hour HH:MM format
  - `posts_count` integer: Number of currently scheduled posts

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)