Skip to main content
GET
List contacts
Deleted, merged and test records are excluded.

Authorizations

Authorization
string
header
required

An API key (tars_sk_…) sent as Authorization: Bearer <key>. Each operation names the permission it needs. Create keys in Settings → Integrations → API keys.

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string

The nextCursor of the previous page.

Maximum string length: 1024
tag
string

Only contacts with this tag.

origin
enum<string>

Only contacts created this way.

Available options:
inbound,
imported,
manual,
outbound_call

Response

One page of results.

One page of a list.

items
object[]
required
nextCursor
string | null
required

Pass it as cursor to read the next page.

hasMore
boolean
required