SMS
Get Message Details
Get the delivery status and details of a specific message
GET /api/sms/messages/{message_id}
| Field | Type | Description |
|---|
message_id | string (UUID) | The message_id returned when the message was sent |
curl "https://sms.lamah.com/api/sms/messages/a3a7b9a2-9d3f-4a7e-9b4e-13b1e9b1f2aa" \
-H "Authorization: Bearer YOUR_API_TOKEN"
The endpoint returns an array containing the message object:
[
{
"short_message": "Your appointment is confirmed for Tuesday at 4:30 PM.",
"message_type": "sms",
"send_type": "single",
"contact_group_id": null,
"message_consumption": 1,
"receiver": [
{
"number": "00218912345678",
"sent_at": "2024-01-15T10:30:02Z",
"delivered_at": "2024-01-15T10:30:15Z",
"status": "delivered",
"delivery_report": null,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:15Z"
}
]
}
]
| Field | Type | Description |
|---|
short_message | string | The message content |
message_type | string | Always sms for SMS messages |
send_type | string | single or multiple |
contact_group_id | string|null | Contact group UUID if applicable |
message_consumption | integer | SMS parts consumed for this message |
receiver | array | List of receipt objects (one per recipient) |
| Field | Type | Description |
|---|
number | string | Recipient phone number |
sent_at | string | ISO 8601 timestamp when message was sent |
delivered_at | string | ISO 8601 timestamp when message was delivered |
status | string | Delivery status for this recipient |
delivery_report | string|null | Raw delivery report if available |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
| Status | Description |
|---|
pending | Queued, not yet sent |
sent | Delivered to the network |
delivered | Confirmed delivery to recipient |
failed | Failed due to a technical issue |
expired | Message expired before delivery |
rejected | Rejected by the network |
{ "message": "Message not found" }
{ "message": "Unauthenticated." }
{ "message": "Message does not belong to your project" }