curl --request GET \
--url 'https://console.eka.care/conversations/<conversation-id>/messages/' \
--header 'Authorization: Bearer <token>'
{
"messages": [
{
"msg_id": "1789461095244-0",
"role": "user",
"content": [
{ "type": "text", "text": "How can I get rid of kidney stones faster?", "tid": "0" }
],
"usage": null
},
{
"msg_id": "1789461095272-0",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Drinking plenty of water usually helps. A urologist can advise on the best treatment for your case. Would you like me to find a specialist?",
"tid": "1"
},
{
"type": "tool_call",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"tool_name": "elicit_selection",
"tool_input": {
"component": "pills",
"text": "How would you like to continue?",
"options": ["Find a urologist", "Book an appointment", "More information"]
}
}
],
"usage": { "input_tokens": 2, "output_tokens": 445, "latency_ms": null }
},
{
"msg_id": "1789461174145",
"role": "tool",
"content": [
{
"type": "tool_result",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"result": "Find a urologist"
}
],
"usage": null
}
],
"feedback": {
"present": false,
"type": "default",
"nps_base5": null,
"options": []
},
"user_context": null,
"tz": "Asia/Kolkata",
"initial_context": {}
}
MedAssist APIs
Get Messages
Returns the full transcript of a MedAssist conversation, including tool calls, user feedback and session context.
GET
/
conversations
/
{conversation_id}
/
messages
/
curl --request GET \
--url 'https://console.eka.care/conversations/<conversation-id>/messages/' \
--header 'Authorization: Bearer <token>'
{
"messages": [
{
"msg_id": "1789461095244-0",
"role": "user",
"content": [
{ "type": "text", "text": "How can I get rid of kidney stones faster?", "tid": "0" }
],
"usage": null
},
{
"msg_id": "1789461095272-0",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Drinking plenty of water usually helps. A urologist can advise on the best treatment for your case. Would you like me to find a specialist?",
"tid": "1"
},
{
"type": "tool_call",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"tool_name": "elicit_selection",
"tool_input": {
"component": "pills",
"text": "How would you like to continue?",
"options": ["Find a urologist", "Book an appointment", "More information"]
}
}
],
"usage": { "input_tokens": 2, "output_tokens": 445, "latency_ms": null }
},
{
"msg_id": "1789461174145",
"role": "tool",
"content": [
{
"type": "tool_result",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"result": "Find a urologist"
}
],
"usage": null
}
],
"feedback": {
"present": false,
"type": "default",
"nps_base5": null,
"options": []
},
"user_context": null,
"tz": "Asia/Kolkata",
"initial_context": {}
}
Use this endpoint to read everything that happened in one conversation: user messages, agent replies, tool calls and their results, plus any feedback the user left.
Get the conversation ID from the
data-session-id values returned by Get Conversation.
Headers
string
required
Bearer token. Format:
Bearer <token>Path parameters
string
required
ID of the conversation (the
data-session-id value from Get Conversation).Response
object[]
Messages in the order they were sent.
Show properties
Show properties
string
Unique ID of the message.
string
Who produced the message:
user, assistant or tool.object[]
Parts that make up the message. Each part has a
type:text: plain text. Fields:text,tid(ID of the text part).tool_call: the agent called a tool (assistant messages only). Fields:tool_id,tool_name,tool_input(object with the tool’s arguments).tool_result: the result returned for a tool call (tool messages only). Fields:tool_id(matches thetool_call),result, and optionalsources(array of{ "label", "url" }).
elicit_selection, result holds the option the user picked or the text they typed.object
object | null
string | null
Timezone of the session, as an IANA name (for example
Asia/Kolkata).object
Context that was passed when the session was created. Empty object if none.
This response can contain patient health information and personal details. Store and display it according to your data-protection obligations.
curl --request GET \
--url 'https://console.eka.care/conversations/<conversation-id>/messages/' \
--header 'Authorization: Bearer <token>'
{
"messages": [
{
"msg_id": "1789461095244-0",
"role": "user",
"content": [
{ "type": "text", "text": "How can I get rid of kidney stones faster?", "tid": "0" }
],
"usage": null
},
{
"msg_id": "1789461095272-0",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Drinking plenty of water usually helps. A urologist can advise on the best treatment for your case. Would you like me to find a specialist?",
"tid": "1"
},
{
"type": "tool_call",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"tool_name": "elicit_selection",
"tool_input": {
"component": "pills",
"text": "How would you like to continue?",
"options": ["Find a urologist", "Book an appointment", "More information"]
}
}
],
"usage": { "input_tokens": 2, "output_tokens": 445, "latency_ms": null }
},
{
"msg_id": "1789461174145",
"role": "tool",
"content": [
{
"type": "tool_result",
"tool_id": "toolu_01AbCdEfGhIjKlMnOpQrStUv",
"result": "Find a urologist"
}
],
"usage": null
}
],
"feedback": {
"present": false,
"type": "default",
"nps_base5": null,
"options": []
},
"user_context": null,
"tz": "Asia/Kolkata",
"initial_context": {}
}
Was this page helpful?