Telephony

Get an outbound call

Current state of one outbound call. Requires telephony:manage.

get/v1/telephony/calls/{id}

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/v1/telephony/calls/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Response

Outbound call

objectstring
idstring
from_number_idstring
tostring
agent_idstring
use_case'transactional' | 'support' | 'sales' | 'collections' | 'survey'
routing_profile'quality_first' | 'balanced' | 'cost_optimized'
status'queued' | 'dispatching' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'canceled' | 'dispatch_unknown'
attempt_countinteger
max_attemptsinteger
failure_reason'network_unavailable' | 'congestion' | 'timeout' | 'no_answer' | 'busy' | 'rejected' | 'invalid_number' | 'identity_blocked' | 'compliance_blocked' | 'unknown' | 'null' nullable
created_atinteger

Unix ms.

updated_atinteger

Unix ms.

answered_atinteger nullable

Unix ms.

ended_atinteger nullable

Unix ms.

Example response

{
  "object": "telephony.call",
  "id": "tcall_...",
  "to": "+14155550123",
  "artifacts": {
    "usage": {
      "meter": "telephony.minutes"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.