Chats

List chats

GET

Query parameters

page_numberintegerOptional

Specifies the page number to retrieve, enabling pagination.

This parameter uses zero-based indexing. For example, setting page_number to 0 retrieves the first page of results (items 0-9 if page_size is 10), setting page_number to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.

page_sizeintegerOptional

Specifies the maximum number of results to include per page, enabling pagination.

The value must be greater than or equal to 1. For example, if page_size is set to 10, each page will include up to 10 items. Defaults to 10.

ascending_orderbooleanOptional
Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.

Response

This endpoint returns an object
page_number
integer

The page number of the returned list.

This value corresponds to the page_number parameter specified in the request. Pagination uses zero-based indexing.

page_size
integer

The maximum number of items returned per page.

This value corresponds to the page_size parameter specified in the request.

total_pages
integer
The total number of pages in the collection.
pagination_direction
enum

Indicates the order in which the paginated results are presented, based on their creation date.

It shows ASC for ascending order (chronological, with the oldest records first) or DESC for descending order (reverse-chronological, with the newest records first). This value corresponds to the ascending_order query parameter used in the request.

Allowed values: ASCDESC
chats_page
list of objects

List of Chats and their metadata returned for the specified page_number and page_size.

Built with