Call Status

Retrieve the current state, duration, and metadata of a voice call.

GET

/v1/voice/call/:callId

Request Parameters

Parameter	Type	Description
callId	Path	The unique ID returned when the call was initiated

Response

JSON

{
  "success": true,
  "data": {
    "callId": "call_xyz123abc",
    "status": "completed",
    "to": "233555539152",
    "from": "233241234567",
    "duration": 45,
    "cost": 0.12,
    "startTime": "2024-01-15T10:30:05Z",
    "endTime": "2024-01-15T10:30:50Z"
  }
}

Status Types

queued

Call is scheduled to be made

ringing

The recipient's phone is ringing

in-progress

The call is active and connected

completed

The call ended normally

busy

The recipient's line was busy

failed

Call failed to connect

no-answer

The recipient did not answer

Cost & Duration

The duration (in seconds) and cost fields are only populated once the call reaches a terminal state (like completed or failed).