GET
https://app.evoriqa.com/api/v1/channelsList connected channels
Returns the connectable channel types and the workspace's connected channels. Offset-paginated (`?skip`/`?take`) with optional type/chatbot-name search and a chatbot filter.
Requires scope channels:read
Warning:
Access is gated — enable it before your first call
The API is off by default. A request succeeds only when all three switches are on: the platform master switch (off by default), your organisation’s API toggle, and your plan or client entitlement. Any one off returns 403 API access is not enabled for this workspace.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| skip | query | integer ≥ 0 | Optional | 0 | Offset pagination: rows to skip. |
| take | query | integer 1–200 | Optional | — | Offset pagination: rows to return. |
| q | query | string | Optional | — | Type or chatbot-name search. |
| chatbotId | query | string uuid | Optional | — | Only channels of this chatbot. |
Request
curl
curl "https://app.evoriqa.com/api/v1/channels" \
-H "x-api-key: $EVORIQA_API_KEY"Node.js
const res = await fetch("https://app.evoriqa.com/api/v1/channels", {
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/channels",
headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
)
body = res.json()Response
200 OK
{
"success": true,
"data": {
"types": [
"email",
"whatsapp",
"messenger",
"instagram",
"slack",
"sms",
"voice"
],
"channels": [
{
"id": "0b8de9f2-4c11-4f7e-9a34-5c6d7e8f9a0b",
"type": "whatsapp",
"chatbotId": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"active": true,
"aiFirst": true,
"lastInboundAt": "2026-08-09T18:20:00.000Z",
"lastRejectedAt": null,
"createdAt": "2026-07-01T08:00:00.000Z"
}
],
"total": 1
}
}