List SMS history
Sent, failed and scheduled texts from SMS > History, newest first, with status, number and date.
GET https://cotlet.dev/api/v1/clicksend/sms-histories
read
Returns one page of SMS > History, 50 messages to a page; pass next_cursor back as cursor for older ones. History shows two statuses: Sent means ClickSend handed the message to the carrier, not that it arrived. Quick SMS messages scheduled for later show here with their send time; scheduled campaigns do not, use list_sms_campaigns. ClickSend keeps full message data for four months.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | sent or failed. Default: both. |
| to string | string | Recipient number. |
| from string | string | Sender number or alpha tag. |
| contact_name string | string | Name of a contact. |
| date_from date | date | Messages on or after this date. |
| date_to date | date | Messages on or before this date. A future date shows messages scheduled to send. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/clicksend/sms-histories \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("clicksend", "list_sms_history")const result = await cotlet.call('clicksend', 'list_sms_history');cotlet call clicksend list_sms_historyExample response
{
"messages": [
{
"message_id": "7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92",
"to": "+447700900142",
"from": "+15550100188",
"status": "failed",
"sent_at": "2026-10-22 18:04"
},
{
"message_id": "3B9A5E70-12C4-4D8F-A6B3-0E7D4C2F1A58",
"to": "+447700900177",
"from": "+15550100188",
"status": "sent",
"sent_at": "2026-10-22 18:04"
}
],
"next_cursor": null
}