Contacts

Read the contacts VOIX matched or created from your calls. Requires a Full access key.

List contacts


GET https://api.voix.tech/public/v1/contacts

Returns contacts alphabetically, paginated. Each contact includes the topics of its calls, most frequent first.

Query parameter	Type	Description
`page`	integer	Page number, from `1`.
`pageSize`	integer	Items per page, `1` to `100`. Default `20`.
`topicIds`	uuid list	Contacts with calls tagged with any of these topics, comma separated.


{
  "data": [
    {
      "id": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a",
      "name": "Alex Jansen",
      "company": "Jansen Installaties",
      "email": null,
      "phone": "+31612345678",
      "jobTitle": null,
      "description": null,
      "website": null,
      "address": null,
      "city": "Utrecht",
      "postalCode": null,
      "country": "Netherlands",
      "topics": [{ "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "name": "Payment plan", "count": 2 }],
      "createdAt": "2026-10-09T14:06:02.000Z",
      "updatedAt": "2026-10-09T14:06:02.000Z"
    }
  ],
  "total": 51,
  "page": 1,
  "pageSize": 20,
  "totalPages": 3
}

To fetch a contact’s calls, use GET /calls?contactId=….

Get a contact


GET https://api.voix.tech/public/v1/contacts/{id}

Returns a single contact in the same shape, without topics.