List messages
/api/v1/communicationsNeeds a key with the full scope.
Newest first, across every channel. unread_count is the account-wide
figure for the key's principal and is returned beside the page, so a
badge needs no second call.
Parameters
Query
qstringcustomer_iduuidtrip_iduuidchannelstringdirectionenumone of
inboundoutboundinternalthread_idstringReturns the whole conversation.
scopeenumone of
unreadlimitintegerdefault 25Rows per page.
cursorstringOpaque; take it from the previous response's
page.next_cursor.
Response · 200
dataobject[]requiredShow fieldsHide fields
iduuidcustomer_iduuidnullabletrip_iduuidnullabledirectionenumone of
inboundoutboundinternalchannelstringstatusstringnullablesubjectstringnullablepreviewstringnullableFirst 160 characters of the plain body.
content_maskedbooleanTrue when the role cannot read message content.
subject,previewand both bodies are thennull.from_addressstringnullableto_addressesstring[]thread_idstringnullablesent_atdate-timenullabledelivered_atdate-timenullableread_atdate-timenullablecreated_atdate-timeunreadboolean
pageobjectrequiredThe cursor for the list beside it. Re-send the same request with
?cursor=<next_cursor>whilehas_moreis true.next_cursorisnullon the last page.Show fieldsHide fields
next_cursorstringrequirednullablehas_morebooleanrequiredlimitintegerrequired
unread_countintegerrequired
Responses
401Missing or invalid Bearer token403Policy denied or account has no owner429Rate limit exceeded
curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/communications' \
-H 'Authorization: Bearer sek_YOUR_API_KEY'{
"data": [
{
"id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
"customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
"trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
"direction": "inbound",
"channel": "email",
"status": "confirmed",
"subject": "Confirm the hotel allocation",
"preview": "Hello Ayşe, your itinerary is attached.",
"content_masked": true,
"from_address": "operations@agency.example",
"to_addresses": [
"ayse@example.com"
],
"thread_id": "thr_8f14e45fea2c",
"sent_at": "2026-03-14T09:30:00Z",
"delivered_at": "2026-03-14T09:30:00Z",
"read_at": "2026-03-14T09:30:00Z",
"created_at": "2026-03-14T09:30:00Z",
"unread": true
}
],
"page": {
"next_cursor": "MjAyNi0wMy0xNFQwOTozMDowMC4wMDAwMDBafDk0MQ",
"has_more": true,
"limit": 25
},
"unread_count": 3
}