Skip to main content
Version: 2.0

List Conversations API Definition

The List Conversations API lists all the conversations in a customer account. This data enables developers to monitor chatbot interactions and understand how users engage with the data. Pagination lets developers navigate through large datasets.

Conversation Object Definition

The conversation object specifies a unique turn id, which is the first turn in the conversation. The unique conversation_id then specifies the conversation within the chat history corpus.

The num_results (default 5) specifies the maximum number of conversations to return, and page_key retrieves a specific page of results. Leave it blank to get the first page.

REST Example

List Conversations Endpoint Address

Vectara exposes an HTTP endpoint at the following URL to list conversations in the chat history corpus:
https://api.vectara.io/v2/chats

The API Reference shows the full List Conversations REST definition.

gRPC Example

You can find the full List Conversations gRPC definition at chat.proto.