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

Send SMS Cancel SMS

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