Get a phone call
Full call detail, including the transcript segments when transcription was on.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.voice.getVoiceCall({ path: { id: 'abc123', },});console.log(data);{
"call": {
"_id": "string",
"accountId": "string",
"conversationId": "string",
"contactId": "string",
"channel": "whatsapp",
"direction": "inbound",
"from": "string",
"to": "string",
"forwardTo": "string",
"greeting": "string",
"status": "ringing",
"isVoicemail": true,
"amd": true,
"answeredMachine": true,
"forwardCallerId": "business",
"recordingEnabled": true,
"transcriptionEnabled": true,
"transcriptionLanguage": "auto",
"startedAt": "2019-08-24T14:15:22Z",
"answeredAt": "2019-08-24T14:15:22Z",
"endedAt": "2019-08-24T14:15:22Z",
"transferredAt": "2019-08-24T14:15:22Z",
"durationSeconds": 0,
"endReason": "hangup",
"hangupCause": "string",
"sipHangupCause": "string",
"callErrors": [
{
"code": 0,
"message": "string"
}
],
"recordingUrl": "string",
"lastTranscriptSnippet": "string",
"transcript": [
{
"text": "string",
"confidence": 0,
"at": "2019-08-24T14:15:22Z"
}
],
"billing": {
"metaMinutes": 0,
"telnyxSeconds": 0,
"transcriptionSeconds": 0,
"transcriptionCostUSD": 0,
"metaCostUSD": 0,
"telnyxCostUSD": 0,
"recordingCostUSD": 0,
"billableCostUSD": 0,
"totalCostUSD": 0,
"currency": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}Get a call recording GET
Resolves a fresh, playable MP3 URL for the call's recording (provider-signed URLs expire ~10 minutes after signing, so this endpoint re-signs on demand). Default responds `302 Found` redirecting to the fresh URL; pass `as=json` to receive `{ url }` instead.
Dial from the browser softphone POST
Step 2 of the browser softphone handshake: places an outbound call whose answered leg is bridged to the browser registered with the credential from `POST /v1/voice/calls/web`. The call runs through the normal outbound lane, so it is logged as outbound (from = your number, to = target) and recorded per the number's settings.