Bandwidth · Schema
Bandwidth Call
Represents a voice call managed through the Bandwidth Voice API, including outbound and inbound calls with state tracking, recording references, and call control metadata.
CommunicationsCPaaSVoiceMessagingTelephonySMSMFA
Properties
| Name | Type | Description |
|---|---|---|
| callId | string | The unique identifier for the call, assigned by Bandwidth |
| accountId | string | The Bandwidth account ID that owns the call |
| applicationId | string | The Bandwidth application ID associated with the call |
| from | string | The originating phone number in E.164 format |
| to | string | The destination phone number in E.164 format |
| direction | string | The direction of the call |
| state | string | The current state of the call |
| answerUrl | string | The URL that receives the answer webhook and returns BXML |
| answerMethod | string | The HTTP method for the answer webhook |
| disconnectUrl | string | The URL that receives the disconnect webhook |
| disconnectMethod | string | The HTTP method for the disconnect webhook |
| startTime | string | The ISO 8601 timestamp when the call was initiated |
| answerTime | string | The ISO 8601 timestamp when the call was answered |
| endTime | string | The ISO 8601 timestamp when the call ended |
| disconnectCause | string | The reason the call was disconnected (e.g., hangup, timeout, cancel) |
| callTimeout | number | The timeout in seconds for the outbound call to be answered |
| callbackTimeout | number | The timeout in seconds for webhook callback requests |
| tag | string | A custom string attached to the call for tracking purposes |
| callUrl | string | The URL for this call resource in the Bandwidth API |