API Reference

VOIX has two APIs. Both are authenticated with an API key from your workspace.

API	Base URL	Purpose
Ingest	`https://ingest.voix.tech/v1`	Send calls to VOIX: a recording plus a little metadata.
REST	`https://api.voix.tech/public/v1`	Read the results (calls, transcripts, scores, checks, tasks, contacts, topics) and manage lenses, checks and topics.

VOIX analyses what is said in a call, not how people sound: there is no emotion recognition on voices and no voiceprints.

How it works

Create an API key

An admin creates a key under Organisation → API with Full access or Sending access (sending calls only). See Authentication.

Send calls

You POST each call to /v1/submit on the Ingest API, once when the call starts and again with the recording when it ends. VOIX transcribes and analyses it automatically; track its status from received to completed.

Read the results

Fetch calls with their transcript, scores, topics and check results, and the tasks and contacts VOIX derived from them. Topics, lenses and checks can be managed through the same API.

Sending a call


curl -X POST https://ingest.voix.tech/v1/submit \
  -H "Authorization: Bearer vx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "recordingUrl": "https://recordings.example.com/call-12345.mp3",
    "from": "+31612345678",
    "to": "+31201234567",
    "startTime": "2026-06-16T09:05:35.000Z",
    "outgoing": false,
    "duration": 184
  }'

Continue to the full field reference and two-step flow.

Reading a call


curl https://api.voix.tech/public/v1/calls/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed \
  -H "Authorization: Bearer vx_your_api_key"

See Calls for the response and the list endpoint.