List Contacts

Retrieves a paginated list of contacts with optional search filtering by name, email, or phone number.

List contacts

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

searchstringOptional

Search contacts by name, email, or phone

pageinteger · min: 1Optional

Page number for pagination

Responses

200

List of contacts

application/json

get

/contacts

HTTPcURLJavaScriptPython

GET /api/v1/contacts HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of contacts

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "first_name": "text",
      "last_name": "text",
      "email": "[e-mail]",
      "phone_number": "text",
      "date_of_birth": "2026-02-03",
      "email_consent": false,
      "sms_consent": false,
      "whatsapp_consent": false,
      "created_at": "2026-02-03T17:55:06.570Z",
      "updated_at": "2026-02-03T17:55:06.570Z"
    }
  ],
  "links": {},
  "meta": {}
}