GET /v1/contacts

List and search contacts

Cursor-paginated list of the tenant contacts (deleted/anonymized contacts are excluded). Requires scope write:deals.

Автентифікація: заголовок Authorization: Bearer rv_live_... (API-ключі та scopes)
Потрібний scope: write:deals

Опис операції, параметрів і полів походить зі специфікації OpenAPI (openapi.json) і подається англійською, як у самому API.

Параметри

Поле	Де	Тип	Обов’язк.	Опис
`q`	query	`string`	ні	Search by name, phone digits, email or Telegram.
`type`	query	`string`	ні	Comma-separated: lead,client,partner,supplier,other.
`tag`	query	`string`	ні
`owner_user_id`	query	`string (uuid)`	ні
`unassigned`	query	`"true" \| "false"`	ні
`sort`	query	`"createdAt" \| "updatedAt" \| "fullName"`	ні
`dir`	query	`"asc" \| "desc"`	ні
`cursor`	query	`string`	ні	nextCursor from the previous page.
`limit`	query	`integer`	ні

A page of contacts.

application/json · Схема: ContactPage

Поле	Тип	Обов’язк.	Опис
`items`	`object[]`	так
`items[].id`	`string (uuid)`	ні
`items[].type`	`"lead" \| "client" \| "partner"`	ні
`items[].fullName`	`string`	ні
`items[].phones`	`string[]`	ні	E.164.
`items[].emails`	`string[]`	ні
`items[].telegramId`	`string \| null`	ні
`items[].telegramUsername`	`string \| null`	ні
`items[].viberId`	`string \| null`	ні
`items[].source`	`"site" \| "telegram" \| "instagram" \| "referral" \| "ads" \| "manual" \| "viber" \| "widget" \| "extension" \| "api" \| "import" \| "marketplace"`	ні
`items[].ownerUserId`	`string \| null (uuid)`	ні
`items[].tags`	`string[]`	ні
`items[].consentMarketing`	`boolean`	ні
`items[].preferredChannel`	`"telegram" \| "viber" \| "email" \| "sms" \| "webhook" \| "in_app" \| null`	ні
`items[].locale`	`"uk" \| "pl" \| "en"`	ні
`items[].notes`	`string \| null`	ні
`items[].createdAt`	`string`	ні	ISO 8601 date-time (UTC).
`items[].updatedAt`	`string`	ні	ISO 8601 date-time (UTC).
`nextCursor`	`string \| null`	так