Skip to main content
GET
/
api
/
v1
/
reporting
/
tenants
/
{tenantId}
/
assistant
/
conversations
List assistant conversations (reporting format)
curl --request GET \
  --url https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations \
  --header 'Authorization: Bearer <token>'
{
  "total": 123,
  "cursor": {
    "next": "<string>"
  },
  "data": [
    {
      "ID": "<string>",
      "TenantID": "<string>",
      "BotID": "<string>",
      "BotName": "<string>",
      "Datetime": 123,
      "EndDatetime": 123,
      "DatetimeUTC": "2023-11-07T05:31:56Z",
      "EndDatetimeUTC": "2023-11-07T05:31:56Z",
      "Duration": 123,
      "Escalated": true,
      "escalatedAt": 123,
      "CSat": 123,
      "AgentName": "<string>",
      "AgentId": "<string>",
      "AgentEmail": "<string>",
      "Category": "<string>",
      "Subcategory": "<string>",
      "Tertiary": "<string>",
      "RemoteIp": "<string>",
      "userAgent": "<string>",
      "Referrer": "<string>",
      "Media": "<string>",
      "Summary": "<string>",
      "Handoff Reason": "<string>",
      "ticketId": "<string>",
      "ticketUrl": "<string>",
      "ticketKind": "<string>",
      "Input": "<string>",
      "Contact Name": "<string>",
      "Contact Email": "<string>",
      "Contact Phone": "<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