Skip to main content
GET
/
api
/
v1
/
reporting
/
tenants
/
{tenantId}
/
voc
/
conversations
List VOC conversations (reporting format)
curl --request GET \
  --url https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/voc/conversations \
  --header 'Authorization: Bearer <token>'
{
  "total": 123,
  "cursor": {
    "next": "<string>"
  },
  "data": [
    {
      "ID": "<string>",
      "TenantID": "<string>",
      "Datetime": "2023-11-07T05:31:56Z",
      "DatetimeUTC": "2023-11-07T05:31:56Z",
      "Duration": 123,
      "Direction": "<string>",
      "Media": "<string>",
      "AgentName": "<string>",
      "AgentId": "<string>",
      "AgentEmail": "<string>",
      "CustomerName": "<string>",
      "CustomerId": "<string>",
      "CustomerEmail": "<string>",
      "Groups": "<string>",
      "Tags": "<string>",
      "Category": "<string>",
      "Subcategory": "<string>",
      "Tertiary": "<string>",
      "CategoryExplanation": "<string>",
      "CategoriesId": "<string>",
      "Summary": "<string>",
      "CSat": 123,
      "CSatExplanation": "<string>",
      "Sentiment": 123,
      "SentimentExplanation": "<string>",
      "Problems": [
        {}
      ],
      "KPIs": [
        {}
      ],
      "SourceSystem": "<string>",
      "TicketId": "<string>",
      "TicketUrl": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tenantId
string
required

Tenant identifier.

Query Parameters

​
limit
integer<int32>

Max results per page. Default 1000, max 5000.

Required range: 1 <= x <= 5000
​
cursor
string

Opaque cursor returned in cursor.next. When provided, do not also supply range, from, or to.

​
range
enum<string>

Convenience range selector. If omitted and from is omitted, defaults to last_day.

Available options:
last_day,
last_week,
last_month
​
from

Range start. Accepts an ISO 8601 timestamp or epoch milliseconds. Epoch milliseconds.

​
to

Range end. Accepts an ISO 8601 timestamp or epoch milliseconds. Defaults to now. Epoch milliseconds.

Response

OK

​
total
integer<int64>
required
​
cursor
object
required
​
data
object[]
required