curl --request GET \
--url https://api.onlyx.ai/v1/conversations/counts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/conversations/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/conversations/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ai": 1102,
"aiOff": 35,
"handoff": 7,
"team": 96,
"total": 1240,
"unread": 58
}Count conversations
Returns how many conversations are in each status, and how many have unread fan messages, for every visible creator or for one with creatorId. Use it for badges and dashboards instead of paging through the list. It scans the whole inbox, so it has its own limit of 30 calls per 60 seconds per credential.
Scope: requires inbox:read.
Rate limits: 30 requests per 60 seconds per credential — on top of the general limit of 120 requests per 60 seconds per credential.
curl --request GET \
--url https://api.onlyx.ai/v1/conversations/counts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/conversations/counts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/conversations/counts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ai": 1102,
"aiOff": 35,
"handoff": 7,
"team": 96,
"total": 1240,
"unread": 58
}Authorizations
An API key (onx_sk_…) created in OnlyX under Settings → API & MCP, or an OAuth access token (onx_at_…) issued to a connected app. Send it as Authorization: Bearer <credential>. API keys may also be sent as X-API-Key: <key>.
Query Parameters
Only this creator's conversations.
40Response
How many conversations are in each status, and how many have unread fan messages.
Conversations the AI answers.
Conversations with the AI switched off.
Conversations handed off and waiting for your team.
Conversations your team has taken over.
All conversations.
Conversations with at least one unread fan message.