> ## Documentation Index
> Fetch the complete documentation index at: https://developer.eka.care/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Conversation
> Returns the conversations (sessions) for a MedAssist agent as an HTML page, with optional filters.
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](/api-reference/health-ai/medassist/get-messages).
## Headers
Bearer token. Format: `Bearer `
## Query parameters
ID of the agent whose conversations you want to list.
All other parameters are optional filters.
### Date
Preset date range. One of `today`, `7d`, `30d`, `month`, `custom`, `all`.
Use `custom` together with `date_from` and `date_to`.
Start date (inclusive), format `YYYY-MM-DD`. Used when `date_preset=custom`.
End date (inclusive), format `YYYY-MM-DD`. Used when `date_preset=custom`.
### Lookup
Return only the conversation with this session ID. Other filters are ignored when this is set.
### Tool usage
Return only conversations in which the agent called this tool.
Narrow `filter_tool_name` to calls where this input parameter was set. Requires `filter_tool_name`.
Value that `filter_tool_param_name` must equal. Requires `filter_tool_name`.
### Feedback
`1` = only conversations with end-user feedback, `0` = only conversations without it. Omit for all.
`1` = only conversations with annotation feedback, `0` = only conversations without it. Omit for all.
Return only conversations annotated by this user ID.
### Channel
One of `web`, `whatsapp`, `voice`. Repeat the parameter to include several channels,
for example `filter_channel=web&filter_channel=whatsapp`.
### Message count
Minimum total number of messages in the conversation.
Maximum total number of messages in the conversation.
Minimum number of messages sent by the user.
Maximum number of messages sent by the user.
### Pagination
Page number.
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 (`
`) with a `data-session-id` attribute. That value is the conversation ID to pass to [Get Messages](/api-reference/health-ai/medassist/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
```python Python theme={null}
import re
import requests
resp = requests.get(
"https://console.eka.care/conversations/",
headers={"Authorization": "Bearer "},
params={"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)
```
```javascript JavaScript theme={null}
const res = await fetch(
"https://console.eka.care/conversations/?agent_id=&date_preset=7d&page_size=50",
{ headers: { Authorization: "Bearer " } }
);
const html = await res.text();
const sessionIds = [...html.matchAll(/data-session-id="([0-9a-f-]{36})"/g)].map(m => m[1]);
console.log(sessionIds);
```
To get the next set of conversations, repeat the request with `page=2`, `page=3`, and so on until no session IDs are returned.
```bash cURL theme={null}
curl --request GET \
--url 'https://console.eka.care/conversations/?agent_id=&date_preset=7d&filter_channel=web&page=1&page_size=50' \
--header 'Authorization: Bearer '
```
```html 200 theme={null}