Skip to main content

Call Status Types

Calls progress through these statuses:

Checking Call Status

Live Status (30 Days)

For recent calls, use the live status endpoint:
Response:

Persistent Status (After 30 Days)

For older calls, use the persistent status endpoint:
Live status is cached for 30 days. After that, use the persistent status endpoint for historical data.

Call Lifecycle

1

SCHEDULED

Call is queued in the system
2

ONGOING

Call is connected and conversation is active
3

COMPLETED / MISSED / FAILED

Call has ended with a final status

Status Details

SCHEDULED

  • Call is in queue
  • Waiting to be initiated
  • Can be cancelled

ONGOING

  • Call is connected
  • Conversation in progress
  • Real-time transcription active
  • Duration counter running

COMPLETED

  • Call ended successfully
  • Recording available
  • Transcript available
  • Metrics generated
  • Summary created

MISSED

  • Call was not answered
  • Will retry based on retry strategy
  • No recording or transcript

FAILED

  • Technical error occurred
  • Error message available
  • May retry based on error type

Monitoring Active Calls

Track ongoing calls in real-time:

Error Handling

Common Error Codes

Retry Behavior

  • BUSY: Retries after busyDelay
  • NO_ANSWER: Retries after noAnswerDelay
  • Other errors: May not retry depending on error type

Webhooks for Status Updates

Receive real-time status updates via webhooks:

Webhook Payload


Next Steps

Call Metrics

Get detailed call metrics and analytics

Recordings

Access call recordings and transcripts