Skip to main content
POST
Total chats
Required scopes: reports_read

Authorizations

Authorization
string
header
required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Body

application/json
distribution
enum<string>
default:day

The time distribution of results.

Available options:
hour,
day,
day-hours,
month,
year
timezone
string

The IANA Time Zone identifier (for example, America/Phoenix). By default, the timezone is taken from the request. If not provided, it's taken from the agent's timezone. When the agent's timezone cannot be determined, filters.from is used to derive it.

filters
object

Filters for chats reports. If none provided, the report spans the last seven days. If filters are provided, they must contain exactly one pair of time-based filters (from/to, greetings.from/to, or surveys.from/to).

Response

200 - application/json

OK.

total
integer

The total number of chats in the specified date range.

records
object

Contains distribution objects, for example, day.