API ReferenceEndpointsConversations
Getting a conversation
GET
Returns a conversation with its participants, including each participant's token. Use it to resume a
conversation or to recover a token you lost. A token in its last 7 days, or already expired, is replaced by a new
one valid for another 90 days.
Only the API key that started the conversation can get it. Any other key gets 404.
apiKeyheader
AuthorizationBearer <token>Your Dispatch API key, sent as Authorization: Bearer <key>. Used to start and get conversations. The key
is visible in your website's source, so it only allows starting conversations with the agents you chose.
conversation*stringThe conversation's id.
Format
uuidThe conversation.
application/json- response
data*curl -X GET 'https://api.rundispatch.ai/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "data": { "id": "0199d2f4-0a1b-7c2d-8e3f-405162738495", "agent": { "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b", "name": "Ava", "title": "Support Agent" }, "context": [ { "label": "Name", "description": "The visitor's name", "value": "Jane" }, { "label": "Page", "description": "Page the visitor is on", "value": "/pricing" } ], "created_at": "2026-10-13T08:00:00+00:00", "_links": { "self": { "href": "https://api.rundispatch.ai/v1/conversations/0199d2f4-0a1b-7c2d-8e3f-405162738495" }, "list_messages": { "href": "https://api.rundispatch.ai/v1/conversations/0199d2f4-0a1b-7c2d-8e3f-405162738495/messages" }, "send_message": { "href": "https://api.rundispatch.ai/v1/conversations/0199d2f4-0a1b-7c2d-8e3f-405162738495/messages" } }, "_embedded": { "participants": [ { "id": "0199e4a0-5b6c-7d8e-9f01-23456789abcd", "type": "end_user", "name": "Jane", "email": "jane@example.com", "phone_number": "+639171234567", "token": "8d1kQ2vX7bN4mR9tY3wZ6pL0sH5jF2cA", "token_expires_at": "2027-01-11T08:00:00+00:00" } ] } }}