Skip to main content
GET
List contacts

Authorizations

Authorization
string
header
required

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

Make and revoke keys in Kai, under Settings → API. Kai stores only a hash of the key, so the full key is shown one time.

Query Parameters

limit
integer
default:50

Contacts per page, from 1 to 500. The default is 50.

Required range: 1 <= x <= 500
cursor
string

The next_cursor value of the last response.

Matches a part of the name, email, phone or external id.

owner
string

A member id to list the contacts of one account owner. Send none for the contacts that have no owner.

updated_since
string<date-time>

An ISO 8601 timestamp. Returns contacts changed at or after it.

Response

One page of contacts.

data
object[]
required
next_cursor
string | null
required

Send this as cursor to get the next page. null at the end.

has_more
boolean
required