curl --request GET \
--url 'https://console.eka.care/conversations/?agent_id=<agent-id>&date_preset=7d&filter_channel=web&page=1&page_size=50' \
--header 'Authorization: Bearer <token>'
<!-- Simplified: the full page contains more markup -->
<table>
<tbody>
<tr data-session-id="3f2b1c9a-7d4e-4a61-9b2f-5c8e1d0a6b7c">
<td>3f2b…6b7c</td>
<td data-utc="2026-09-19T14:07:09+00:00">Sep 19, 2026, 2:07 PM UTC</td>
<td>6</td> <!-- messages -->
<td>2</td> <!-- tool calls -->
<td>web</td> <!-- channel -->
</tr>
</tbody>
</table>
MedAssist APIs
Get Conversation
Returns the conversations (sessions) for a MedAssist agent as an HTML page, with optional filters.
GET
/
conversations
/
curl --request GET \
--url 'https://console.eka.care/conversations/?agent_id=<agent-id>&date_preset=7d&filter_channel=web&page=1&page_size=50' \
--header 'Authorization: Bearer <token>'
<!-- Simplified: the full page contains more markup -->
<table>
<tbody>
<tr data-session-id="3f2b1c9a-7d4e-4a61-9b2f-5c8e1d0a6b7c">
<td>3f2b…6b7c</td>
<td data-utc="2026-09-19T14:07:09+00:00">Sep 19, 2026, 2:07 PM UTC</td>
<td>6</td> <!-- messages -->
<td>2</td> <!-- tool calls -->
<td>web</td> <!-- channel -->
</tr>
</tbody>
</table>
Use this endpoint to list the conversations your MedAssist agent has had. Filter by date range, channel, tool usage, feedback, or message count, and page through results.
To read the full transcript of a conversation, pass its session ID to Get Messages.
All other parameters are optional filters.
To get the next set of conversations, repeat the request with
Headers
string
required
Bearer token. Format:
Bearer <token>Query parameters
string
required
ID of the agent whose conversations you want to list.
Date
string
default:"7d"
Preset date range. One of
today, 7d, 30d, month, custom, all.
Use custom together with date_from and date_to.string
Start date (inclusive), format
YYYY-MM-DD. Used when date_preset=custom.string
End date (inclusive), format
YYYY-MM-DD. Used when date_preset=custom.Lookup
string
Return only the conversation with this session ID. Other filters are ignored when this is set.
Tool usage
string
Return only conversations in which the agent called this tool.
string
Narrow
filter_tool_name to calls where this input parameter was set. Requires filter_tool_name.string
Value that
filter_tool_param_name must equal. Requires filter_tool_name.Feedback
string
1 = only conversations with end-user feedback, 0 = only conversations without it. Omit for all.string
1 = only conversations with annotation feedback, 0 = only conversations without it. Omit for all.string
Return only conversations annotated by this user ID.
Channel
string
One of
web, whatsapp, voice. Repeat the parameter to include several channels,
for example filter_channel=web&filter_channel=whatsapp.Message count
integer
Minimum total number of messages in the conversation.
integer
Maximum total number of messages in the conversation.
integer
Minimum number of messages sent by the user.
integer
Maximum number of messages sent by the user.
Pagination
integer
default:"1"
Page number.
integer
default:"50"
Results per page. One of
25, 50, 100.Response
This endpoint returns an HTML page (Content-Type: text/html), not JSON. It lists matching conversations newest first, 50 per page by default.
Each conversation is a table row (<tr>) with a data-session-id attribute. That value is the conversation ID to pass to Get Messages.
A JSON response is planned. Until then, extract the session IDs from the
data-session-id attributes, as shown below.Extracting session IDs
import re
import requests
resp = requests.get(
"https://console.eka.care/conversations/",
headers={"Authorization": "Bearer <token>"},
params={"agent_id": "<agent-id>", "date_preset": "7d", "page_size": 50},
)
session_ids = re.findall(r'data-session-id="([0-9a-f-]{36})"', resp.text)
print(session_ids)
const res = await fetch(
"https://console.eka.care/conversations/?agent_id=<agent-id>&date_preset=7d&page_size=50",
{ headers: { Authorization: "Bearer <token>" } }
);
const html = await res.text();
const sessionIds = [...html.matchAll(/data-session-id="([0-9a-f-]{36})"/g)].map(m => m[1]);
console.log(sessionIds);
page=2, page=3, and so on until no session IDs are returned.
curl --request GET \
--url 'https://console.eka.care/conversations/?agent_id=<agent-id>&date_preset=7d&filter_channel=web&page=1&page_size=50' \
--header 'Authorization: Bearer <token>'
<!-- Simplified: the full page contains more markup -->
<table>
<tbody>
<tr data-session-id="3f2b1c9a-7d4e-4a61-9b2f-5c8e1d0a6b7c">
<td>3f2b…6b7c</td>
<td data-utc="2026-09-19T14:07:09+00:00">Sep 19, 2026, 2:07 PM UTC</td>
<td>6</td> <!-- messages -->
<td>2</td> <!-- tool calls -->
<td>web</td> <!-- channel -->
</tr>
</tbody>
</table>
Was this page helpful?