Skip to main content
GET
List a contact's conversations

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer kai_live_....

Make, edit and revoke keys in Kai, under Settings → API. Kai stores only a hash of the key, so the full key is shown one time. You can change the name and the permissions of a key later without a new key.

Path Parameters

id
string<uuid>
required

The Kai contact id.

Query Parameters

status
enum<string>

open returns the live threads. closed and archived return those states. Omit it for all of them.

Available options:
open,
closed,
archived
limit
integer
default:50
Required range: 1 <= x <= 200

Response

The contact's conversations.

data
object[]