v50

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-06-1841147599.2 KB
Contacts

Get contacts list

Retrieves a paginated list of contacts for the authenticated customer. Supports filtering by search term, channel, or phone number.

get/v3/contacts

Query parameters

pageinteger required

Page number (1-indexed)

page_sizeinteger required

Number of items per page

searchstring nullable

Optional search term for filtering contacts

channelstring nullable

Optional channel filter (sms, whatsapp)

phonestring nullable

Optional phone number filter (alternative to list view)

Headers

x-profile-idstring uuid

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Response

Contacts retrieved successfully

successboolean

Indicates whether the request was successful