Aggregated call report (one row per call)

get

https://analyse.twin24.ai/api/v1/statistics/cis/call/aggregated

Returns CIS calls aggregated into one row per call. Each row carries the rolled-up STT/TTS costs and the last-known call attributes (status, phone number, duration, etc.). Keyset pagination is not supported for this aggregated endpoint; use Limit/Offset/Page.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

from

string

^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\+[0-9]{2}:[0-9]{2}$

The start date (for example, 2018-05-27T21:30:54+00:00). (For get request need encode url)

string

^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\+[0-9]{2}:[0-9]{2}$

The end date (for example, 2018-05-27T21:30:54+00:00). (For get request need encode url)

companyId

integer

The company identifier filter.

callId

string

^[a-z0-9]{8}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{12}$

Filter by call UUID.

status

string

Filter by the final call status.

isIncoming

integer

enum

Filter by call direction (1 - incoming, 0 - outgoing).

Allowed:

botId

string

^[a-z0-9]{8}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{12}$

Filter by bot UUID.

fields

string

Comma-separated list of fields to return. Available fields: callId, companyId, status, phoneNumber, callerId, duration, isIncoming, botId, dialogId, autoCallId, externalId, startedAt, finishedAt, billedAt, lastEventAt, recordPath, price, ttsPrice, sttPrice, speakerPrice, trunkPrice, amdTryPrice, amdDetectedPrice, labelPrice, macPrice, sttSeconds, ttsCharacters, synthesisCount, recognitionCount.

sort

string

Sort field and direction. Each sort field can have a special prefix indicating the desired sort order: + (ascending, default) or - (descending). Available sort fields: startedAt, billedAt, lastEventAt, duration.

limit

integer

Defaults to 10

Maxium number of returning records.

offset

integer

Starting point to return records from a result set.

page

integer

Page number, used to paginate over all records.

timezone

integer

Timezone offset in minutes from UTC.

withoutCount

boolean

Defaults to false

Determines whether to return the total number of records.

withoutItems

boolean

Defaults to false

Determines whether to return the record list.

output

string

enum

Determines the output format. CSV_EXCEL format includes UTF-8 BOM and semicolon delimiter for better Excel compatibility.

Allowed:

Responses

400

Invalid input parameters

401

User is not authenticated

403

Invalid user permissions

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

5XXUnexpected error