Get SMS conversation
The messages of one SMS thread in order, with direction and time.
GET https://cotlet.dev/api/v1/ringover/conversations/{conversation_id}/sms-conversation
read
Returns the messages of one thread, oldest first, each with its direction, text and time. Reading a thread does not send anything. Attachments are named but not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Thread ID from list_sms_conversations. |
Request
curl https://cotlet.dev/api/v1/ringover/conversations/conversation_8c41d2/sms-conversation \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("ringover", "get_sms_conversation", {"conversation_id":"conversation_8c41d2"})const result = await cotlet.call('ringover', 'get_sms_conversation', {"conversation_id":"conversation_8c41d2"});cotlet call ringover get_sms_conversation --data '{"conversation_id":"conversation_8c41d2"}'Example response
{
"conversation_id": "sms_3301",
"number": "+15550100142",
"contact": "Dana Whitfield",
"messages": [
{
"direction": "outgoing",
"text": "Hi Dana, does Thursday at 10 work for the demo?",
"at": "2026-10-22T10:40:00Z"
},
{
"direction": "incoming",
"text": "Thursday at 10 works.",
"at": "2026-10-22T11:02:00Z"
}
]
}