---
title: "Message Status"
method: GET
path: "/message/{unique_id}/status"
tags: ["message"]
---

# Message Status

`GET /message/{unique_id}/status`

This endpoint retrieves the delivery status of a message based on the `unique_id` of the message

## Path parameters

- `unique_id` string, required

## Headers

- `x-phone` string

## Response `200`

200 OK

- object — The response is a JSON object with the current delivery status of the message
  - `queue_id` string — A unique identifier for your 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 unique identifier of the WhatsApp chat (format: {phone_number}@c.us for individual chats or {group_id}@g.us for groups).
  - `performed_by` string — Identifier of who initiated the message (e.g. api, user)
  - `status` string — Current delivery status of the message
  - `status_description` string — The description of the current status of the message
  - `ack` integer — The WhatsApp acknowledgement 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
    - `quoted_message_id` string — The unique message ID of the quoted message, if this was a reply
  - `timeline` object — Timestamps for key events in the message lifecycle
    - `queued_at` string, date-time — Timestamp when the message was added to the queue
    - `sent_at` string, date-time — Timestamp when the message was sent to WhatsApp
  - `attempts` integer — Number of attempts made to send the message
  - `delivered_count` integer — Number of recipients who received the message
  - `read_count` integer — Number of recipients who read the message

---

[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)
