API Reference

The Ingest API is the mechanism for submitting calls to VOIX. You send a recording and a small amount of metadata describing the call; VOIX performs transcription, tone assessment, analysis, task extraction, and contact resolution 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. Submitting the call in a single request is also supported.

VOIX processes the call

The call proceeds through transcription and analysis automatically. You can track its status as it moves 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
  }'

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