API Reference

The Ingest API is how you get calls into VOIX. You send a recording (and a little metadata about the call); VOIX takes care of transcription, tone, analysis, tasks, and contacts from there. There is a single endpoint to integrate.

Base URL


https://ingest.voix.tech

How it works

Authenticate

Every request carries an API key issued from your workspace. See Authentication.

Submit the call

You POST the call to /submit, once when the call starts and again with the recording when it ends. (Sending it all at once also works.)

VOIX does the rest

The call moves through transcription and analysis on its own. You can watch its status move from received to completed.

A minimal example


curl -X POST https://ingest.voix.tech/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
  }'

Read on for the full field reference and the two-step flow.