---
title: "Get message status"
method: POST
path: "/message_status"
tags: ["Message-Status"]
---

# Get message status

`POST /message_status`

## Request

- Base URL: `https://api.commpeak.com/textpeak/streams`
- URL: `https://api.commpeak.com/textpeak/streams/message_status`
- Auth: API key in header `Authorization`

Look up the current delivery status of up to 500 messages by their `message_uuid`. Unknown IDs, and messages sent on another stream, are left out of the results.

Prefer delivery webhooks for real-time updates; use this endpoint to reconcile or backfill.

**Authentication:** stream token in the `Authorization` header (see **Authentication** in the API Overview).

## Request body

- MessagesStatusRequest
  - `message_uuids` string[], required: `message_uuid` values returned by the send endpoints, up to 500.

## Response `200`

Successful Response

- MessagesStatusResponse
  - `results` MessageStatus[], required: One entry per known message. Unknown IDs, and messages of other streams, are left out.
    - `message_uuid` string, required: Message identifier.
    - `created_at` string, nullable: When the message was accepted.
    - `sent_at` string, nullable: When the message was handed to the carrier.
    - `delivered_at` string, nullable: When delivery was confirmed.
    - `status` 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'rejected' | 'no_routes', nullable: Current delivery status.
    - `fail_reason` string, nullable: Reserved; currently always `null`.

## Other responses

- `401`: Invalid token, or the token is not valid from this IP address.
- `402`: Payment required: the account balance is depleted (`0x41`).
- `403`: Missing token, blocked IP address, or the stream is not available (`0x11`, `0x16`, `0x21`, `0x22`).
- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-textpeak-streams-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-textpeak-streams-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-textpeak-streams-api/revisions/b9aaa8b4efa2?raw)