Get SMS message
One text with the reason it failed, error code, number of parts and cost.
GET https://cotlet.dev/api/v1/clicksend/messages/{message_id}/sms-message
read
Returns what the (i) icon on a History row shows: status, the failure reason and error code, how many parts the text had, the cost and the message ID. error_text and error_code are empty for a message that did not fail. message_price is the number the dashboard shows, in the currency of the account.
Parameters
| Name | Type | Description |
|---|---|---|
| message_id string required | string | Message ID from list_sms_history. |
Request
curl https://cotlet.dev/api/v1/clicksend/messages/7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92/sms-message \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("clicksend", "get_sms_message", {"message_id":"7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92"})const result = await cotlet.call('clicksend', 'get_sms_message', {"message_id":"7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92"});cotlet call clicksend get_sms_message --data '{"message_id":"7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92"}'Example response
{
"message_id": "7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92",
"status": "failed",
"to": "+447700900142",
"from": "+15550100188",
"sent_at": "2026-10-22 18:04",
"error_code": "INVALID_RECIPIENT",
"error_text": "Invalid recipient number",
"message_parts": 1,
"message_price": "0.00"
}