Get SMS Status

{
  "message_id": "<string>",
  "status": "<string>",
  "provider_message_id": "<string>",
  "error": "<string>",
  "updated_at": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

sms

{message_id}

status

{
  "message_id": "<string>",
  "status": "<string>",
  "provider_message_id": "<string>",
  "error": "<string>",
  "updated_at": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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

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

Status Values

Status	Description
`queued`	Message is waiting in Burki’s provider queue
`sending`	Message is currently being sent
`sent`	Provider accepted or delivered the message
`failed`	Sending failed; inspect `error`
`cancelled`	Message 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

API Documentation

Assistants

Assistant Phone Numbers

Assistant Documents (RAG)

Voice Cloning

Calls

Messaging

SIP Trunks

Billing

Phone Number Management

Call Data

Organization

Webhooks & System

Campaigns

WebSockets

Tools & Custom Actions

Conversation Flows

Learning & Memory

Path Parameters

Response

Status Values

Error Responses

Authorizations

Path Parameters

Response

​Path Parameters

​Response

​Status Values

​Error Responses

Authorizations

Path Parameters

Response

Path Parameters

Response

Status Values

Error Responses