{
"message_id": "<string>",
"status": "<string>",
"provider_message_id": "<string>",
"error": "<string>",
"updated_at": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Messaging
Get SMS Status
Get the status of a queued SMS message.
Use this endpoint to check if a queued SMS has been delivered, is still pending, or has failed.
Args: message_id: The unique message ID returned when queueing the SMS
Returns: SMSStatusResponse: Current status of the message
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 byPOST /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
| 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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Successful Response
Response model for SMS status endpoint.
⌘I