RinghouseAPI reference
Get started

Conversations

Get a conversation

One thread by id.

GET/v1/conversations/{conversation_id}

Needs the conversations:read scope.

Path parameters

conversation_idstringrequired
Conversation id

Returns

The conversation. A failed call answers with an error instead.

idstring
contactstring
The other end of the thread, in E.164.
createdAtstring
lastItemAtstring
lastItemKindstringnullable
What the most recent activity was: sms_message, call_log, comment, reaction, assignment.
numberIdstring
statusstring
The folder it sits in — `open` or `done` for the two every workspace has.
curl https://api.ringhouse.ai/v1/conversations/{conversation_id} \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "contact": "…",
  "createdAt": "2026-09-25T14:02:11Z",
  "lastItemAt": "2026-09-25T14:02:11Z",
  "lastItemKind": "…",
  "numberId": "e41b09c2-77d3-4c5e-b0a8-9d2f61c4e3a7",
  "status": "completed"
}
Was this page helpful?
Previous← List conversationsNextSet conversation status