Skip to main content
GET
/
sms
/
{message_id}
/
status
{
  "message_id": "<string>",
  "status": "<string>",
  "provider_message_id": "<string>",
  "error": "<string>",
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.burki.dev/llms.txt

Use this file to discover all available pages before exploring further.

Check the current status of a queued SMS message. Use the message_id returned by Send SMS. For queued sends, this is Burki’s internal queue UUID. When the provider returns its own ID, it appears as provider_message_id.

​
Path Parameters

  • message_id (string, required): The Burki message ID returned by POST /sms/send.

​
Response

Response
{
  "message_id": "8ad70ee5-3d47-4fa4-a6ab-c9f2238d5f54",
  "status": "sent",
  "provider_message_id": "SM1234567890abcdef",
  "error": null,
  "updated_at": "2026-04-30T10:15:00Z"
}

​
Status Values

StatusDescription
queuedMessage is waiting in Burki’s provider queue
sendingMessage is currently being sent
sentProvider accepted or delivered the message
failedSending failed; inspect error
cancelledMessage was cancelled before delivery

​
Error Responses

404
{
  "detail": "Message 8ad70ee5-3d47-4fa4-a6ab-c9f2238d5f54 not found"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
message_id
string
required

Response

Successful Response

Response model for SMS status endpoint.

​
message_id
string
required
​
status
string
required

Message status: 'queued', 'sending', 'sent', 'failed', 'cancelled'

​
provider_message_id
string | null

Provider's message ID after delivery

​
error
string | null

Error message if failed

​
updated_at
string | null

Last status update timestamp