---
title: "List Queue Jobs"
method: POST
path: "/message/queues"
tags: ["message"]
---

# List Queue Jobs

`POST /message/queues`

This endpoint returns the jobs in the message queue. Optionally filter by `queue_id` or `broadcast_id`

**Note:** To check the status of a broadcast, pass the `broadcast_id` in the request body. This will return all jobs associated with that broadcast

## Headers

- `x-phone` string

## Request body

- object
  - `queue_id` string — Filter by a specific message queue
  - `broadcast_id` string — Filter by broadcast ID to return all jobs belonging to this broadcast

## Response `200`

200 OK

- object[] — The response is a JSON array of message job objects
  - `queue_id` string — Unique identifier for the message queue
  - `unique_id` string — Provisional message identifier, useful for tracking via /message/{unique_id}/status
  - `message_id` string — A unique identifier for the message, containing information about the chat, sender, and message details.
  - `chat_id` string — The recipient's chat ID, the unique identifier of the WhatsApp chat
  - `performed_by` string — Identifier of who initiated the message (e.g. api, user)
  - `status` 'queued' | 'sending' | 'sent' | 'failed' | 'scheduled' — Current status of the job (queued, sending, sent, failed, scheduled, pending, delivered, read, played)
  - `status_description` string — Description of the current status of the message
  - `message` object — The message content that was sent
    - `body` string — The text body of the message
    - `type` string — The type of the message (e.g. chat, image, video)
  - `timeline` object — Timestamps for key events in the message lifecycle
    - `queued_at` string, date-time — Timestamp when the message job was added to the queue
    - `sent_at` string, date-time — Timestamp when the message was sent to WhatsApp
  - `attempts` integer — Number of send attempts made

---

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