Retrieve the details and current status of a specific message.
Path Parameters
The unique message identifier (e.g., msg_abc123)
Response
Unique message identifier
Channel used (sms, whatsapp, etc.)
Current status: queued, sending, delivered, failed
Template ID if a template was used
Custom metadata attached to the message
External provider’s message ID (e.g., Twilio SID)
Error code if status is failed
Error description if status is failed
ISO 8601 timestamp of creation
ISO 8601 timestamp of last update
{
"message": {
"id": "msg_abc123xyz",
"to": "+56912345678",
"channel": "sms",
"status": "delivered",
"text": "Your verification code is 123456",
"metadata": {
"userId": "user_123"
},
"providerMessageId": "SM1234567890abcdef",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:05.000Z"
}
}
Example
curl https://api.zavu.dev/v1/messages/msg_abc123xyz \
-H "Authorization: Bearer zv_live_xxx"
Message Statuses
| Status | Description |
|---|
queued | Message received and queued for delivery |
sending | Message is being sent to the provider |
delivered | Message successfully delivered |
failed | Message delivery failed |
Set up webhooks to receive real-time status updates instead of polling this endpoint.