Skip to main content
GET
Get Chat History
Retrieve the conversation history of a bot to audit interactions, analyze metrics, or debug flows. This endpoint returns sent and received messages with support for pagination and time filters.

Endpoint


Path Parameters


Query Parameters

If you omit optional fields, the API will apply default values to deliver the first page with the most recent messages.

Request Examples

Basic query

With date filter

With client filter


Responses


Response Detail

pagination object

results object


Limits and restrictions

Important limits:
  • limit: Maximum allowed value is 50
  • page: Must be a positive integer
  • startAt/endAt: Must be in ISO 8601 format (e.g.: 2025-01-15T10:30:00.000Z)

Authorizations

Authorization
string
header
required

Basic authentication using Base64 encoded clientId:clientSecret

Path Parameters

botId
string
required

Query Parameters

limit
integer
default:10
Required range: x <= 50
page
integer
default:1
startAt
string<date-time>
endAt
string<date-time>
clientId
string
messageId
string

Response

History retrieved successfully

pagination
object
_metadata
object
results
object[]