Message-Status

Get message status

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

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

Request body

message_uuidsstring[] required

message_uuid values returned by the send endpoints, up to 500.

Example request

{
  "message_uuids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}

Response

Successful Response

Example response

{
  "results": [
    {
      "created_at": "2026-08-24T08:24:44",
      "message_uuid": "7d1e2c3b-4a59-4b6c-8d7e-9f0a1b2c3d4e",
      "sent_at": "2026-08-24T08:24:44",
      "status": "sent"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.