Retrieve a conversation▾
Retrieve a conversation
Fetch one thread, including how long the session window has left.
Read session_expires_at before sending free-form text — if it is in the past you must send a template. See the session window.
GET
/v1/conversations/{wa_id}Path parameters
wa_idstringrequiredDigits-only WhatsApp id, or conv_….
curl -X GET https://api.sendport.tech/v1/conversations/{wa_id} \
-H "Authorization: Bearer $SENDPORT_KEY"Responses
200OK
{
"object": "conversation",
"id": "conv_01JZQ3F8X0QG7T2S4N8V1PZAKD",
"contact": { "wa_id": "201005550123", "name": "Nadia Haddad" },
"channel_number": "+15550100200",
"status": "open",
"assignee": { "id": "usr_01JZQ0A1", "name": "Amina R.", "email": "amina@example.com" },
"unread_count": 2,
"session_expires_at": "2026-09-07T03:41:02.000Z",
"last_message_at": "2026-09-06T09:41:02.000Z",
"created_at": "2026-08-30T10:02:11.000Z"
}401Unauthorized
{
"error": {
"type": "authentication_error",
"code": "missing_api_key",
"message": "No API key provided.",
"doc_url": "https://sendport.tech/docs/errors#missing_api_key",
"request_id": "req_9f3c2a7b41de08c5b2e6"
}
}Try itsandbox