Get Query Count Data

Counts the queries made in the organization per day of the date window. A query is one message a user sends to an agent, together with the agent's answer.

Versions:

Without an X-API-Version header the response is version 2.0, with the message Engagement data retrieved successfully.

Send X-API-Version: 2.1 (major and minor only) for version 2.1: each row also has query_date_iso, the same value as date. Rows returned with time_series=true don't have it.

Any version other than 2.0 changes the message to Query counts data retrieved successfully. A value that is not in MAJOR.MINOR form, such as 2.1.0, still returns version 2.0 rows.

Current Version:

2.0.0

Changelog:

2.1.0: Adds query_date_iso to each row. Select it with X-API-Version: 2.1.

2.0.0: Initial version.

application/json

data is the list itself. One row per day that had queries, oldest first; with time_series=true, one row per bucket.

Bodyapplication/json

curl --location --globoff 'https:///api/v2/query-counts/?bucket_type=&days=&end_date=&start_date=&time_series=&type=' \ --header 'Organization-Id;' \ --header 'Ocp-Apim-Subscription-Key: ' \ --header 'Authorization: Bearer '

{ "success": true, "message": "Engagement data retrieved successfully", "data": [ { "date": "2026-03-01", "interaction_count": 57 }, { "date": "2026-03-02", "interaction_count": 61 } ] }

Request

Responses