Skip to main content
GET
List Conversations

Authorizations

Authorization
string
header
required

Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).

Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).

Query Parameters

user
string

End-user identifier, defined by your app and unique within it. See End User Identity.

last_id
string

Pagination cursor: the id of the last conversation on the current page. Omit to fetch the first page.

limit
integer
default:20

Number of records to return.

Required range: 1 <= x <= 100
sort_by
enum<string>
default:-updated_at

Field to sort by. Prefix with - for descending order.

Available options:
created_at,
-created_at,
updated_at,
-updated_at

Response

Successfully retrieved conversations list.

limit
integer

Number of items per page.

has_more
boolean

Whether there are more conversations.

data
object[]

List of conversations.