GET
https://app.evoriqa.com/api/v1/conversationsList conversations
Returns the workspace's conversations, newest first and cursor-paginated. Each entry carries its channel, status, and the chatbot that handled it.
Requires scope conversations:read
Note:
Available on every plan
Create a key under Settings → API keys and call it. If you’re a client of an agency or reseller and get 403 API access is not enabled for this workspace., your provider turns the API on for your workspace.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| limit | query | integer 1–200 | Optional | 100 | Maximum number of items to return. Defaults to 100; values above 200 are clamped to 200. |
| cursor | query | string uuid | Optional | — | The nextCursor from the previous page. A malformed cursor is ignored and the first page is returned. |
Request
curl
curl "https://app.evoriqa.com/api/v1/conversations" \
-H "x-api-key: $EVORIQA_API_KEY"Node.js
const res = await fetch("https://app.evoriqa.com/api/v1/conversations", {
headers: {
Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
},
});
const responseBody = await res.json();Python
import os
import requests
res = requests.get(
"https://app.evoriqa.com/api/v1/conversations",
headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
)
body = res.json()Response
200 OK
{
"success": true,
"data": {
"data": [
{
"id": "8c1e4f2a-7b3d-4e91-a2f6-6d1c9b0e4a55",
"chatbotId": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"status": "open",
"source": "public_widget",
"intent": "pricing",
"sentiment": "positive",
"leadScore": 72,
"createdAt": "2026-01-16T14:02:00.000Z"
}
],
"nextCursor": null
}
}