List conversations
Conversations in your inbox: calls and SMS threads, newest activity first.
GET https://cotlet.dev/api/v1/aircall/conversations
read
Lists the Conversations tab of the Aircall Inbox, where calls and messages of one contact sit together. Each row has the contact or number, the line, the last activity, the type of the last item and a short preview of a message. Search by name or number. Page with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Contact name or phone number. |
| limit integer | integer | Page size. |
| cursor string | string | next_cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/aircall/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("aircall", "list_conversations")const result = await cotlet.call('aircall', 'list_conversations');cotlet call aircall list_conversationsExample response
{
"conversations": [
{
"conversation_id": "conv_5521",
"contact": {
"name": "Priya Raman",
"number": "+14155550142"
},
"line": "Sales US",
"last_item": "call",
"last_activity_at": "2026-10-22T16:41:08Z",
"preview": null
}
],
"next_cursor": null
}