---
title: "List schedules"
method: GET
path: "/v1/queue/slots"
tags: ["Queue"]
---

# List schedules

`GET /v1/queue/slots`

Returns queue schedules for a profile. Use all=true for all queues, or queueId for a specific one. Defaults to the default queue.

## Query parameters

- `profileId` string, required
- `queueId` string
- `all` 'true' | 'false'

## Response `200`

Queue schedule(s) retrieved

- union
  - QueueSlotsResponse — Single queue response (default behavior)
    - `exists` boolean
    - `schedule` QueueSchedule
      - `_id` string — Unique queue identifier
      - `profileId` string — Profile ID this queue belongs to
      - `name` string — Queue name (e.g., "Morning Posts", "Evening Content")
      - `timezone` string — IANA timezone (e.g., America/New_York)
      - `slots` QueueSlot[]
        - `dayOfWeek` integer — Day of week (0=Sunday, 6=Saturday)
        - `time` string — Time in HH:mm format (24-hour)
      - `active` boolean — Whether the queue is active
      - `isDefault` boolean — Whether this is the default queue for the profile (used when no queueId specified)
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `nextSlots` string[]
  - object — All queues response (when all=true)
    - `queues` QueueSchedule[]
      - `_id` string — Unique queue identifier
      - `profileId` string — Profile ID this queue belongs to
      - `name` string — Queue name (e.g., "Morning Posts", "Evening Content")
      - `timezone` string — IANA timezone (e.g., America/New_York)
      - `slots` QueueSlot[]
        - `dayOfWeek` integer — Day of week (0=Sunday, 6=Saturday)
        - `time` string — Time in HH:mm format (24-hour)
      - `active` boolean — Whether the queue is active
      - `isDefault` boolean — Whether this is the default queue for the profile (used when no queueId specified)
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `count` integer

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Profile not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)