Skip to main content
GET
List all contacts

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

Sajn-Version
enum<string>

API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.

Available options:
2026-09,
2026-10
Sajn-Workspace
string

ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.

Query Parameters

limit
integer
default:25

Maximum number of items to return, from 1 to 100. Default: 25.

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

The nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.

Required string length: 1 - 2048
include
enum<string>[]

total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.

Available options:
total
query
string

Free-text search across first name, last name, email, phone, and company

email
string

Returns only contacts whose email address equals this value exactly.

phone
string

Returns only contacts whose phone number equals this value exactly. Encode a leading + as %2B.

externalId
string

Returns only the contact whose externalId equals this value exactly.

companyId
string[]

Filter by one or more company IDs. Comma-separated or repeated.

tagId
string[]

Filter by one or more tag IDs. Comma-separated or repeated.

createdAfter
string

Only contacts created at or after this ISO 8601 date or date-time.

createdBefore
string

Only contacts created at or before this ISO 8601 date or date-time.

updatedAfter
string

Only contacts updated at or after this ISO 8601 date or date-time. Use it for incremental sync.

updatedBefore
string

Only contacts updated at or before this ISO 8601 date or date-time.

Response

200

data
object[]
required
hasMore
boolean
required

True if more items follow this page.

nextCursor
string | null
required

Pass this as cursor to get the next page. Null on the last page.

total
integer

The number of items that match the filters. Present only with include=total.

Required range: -9007199254740991 <= x <= 9007199254740991