Bandwidth Voice API

Base API URL

https://voice.bandwidth.com/api/v2/accounts/{accountId}

REST API Reference Index

Resource Description
/calls The Calls resource lets you make phone calls and modify active calls.

BXML verbs

Verb Description
<Forward> The Forward verb is used to forward an unanswered incoming call to another number.
<Gather> The Gather verb is used to collect DTMF digits.
<Hangup> The Hangup verb is used to hangup the current call.
<Pause> The Pause verb is used to delay verb execution for a period of time.
<PauseRecording> The PauseRecording verb is used to pause a recording previously started by a <StartRecording> verb.
<PlayAudio> The PlayAudio verb is used to play an audio file in the call.
<Record> The Record verb allows a segment of audio to be recorded during a call.
<Redirect> The Redirect verb is used to redirect the current XML execution to another URL.
<ResumeRecording> The ResumeRecording verb is used to resume a recording previously paused by a <PauseRecording> verb.
<SendDtmf> The SendDtmf verb is used to play DTMF digits in the call.
<SpeakSentence> The SpeakSentence verb converts text into audible speech.
<StartRecording> The StartRecording verb allows a segment of a call to be recorded while other verbs are executing.
<StopRecording> The StopRecording verb stops a recording that was previously started by a <StartRecording>.
<Transfer> The Transfer verb is used to transfer the call to another number.

BXML Callbacks

Callback Description
Answer Bandwidth API sends this to the application when the call is answered.
Gather Bandwidth API sends this when a <Gather> is completed.
Initiate Bandwidth API sends this to the application when an inbound call arrives.
Record Complete Bandwidth API sends this to the application when a <Record> is completed. The recording is not available to download until the Recording Available event is received.
Redirect Bandwidth API sends this to the application when a <Redirect> is requested or when a POST request is made to the /calls/{callId} endpoint requesting a redirect.
Transfer Answer Bandwidth API sends this to the application when the <Transfer> is answered.
Transfer Complete Bandwidth API sends this to the application when the <Transfer> is complete.

Asynchronous Callbacks

Callback Description
Disconnect Bandwidth API sends this to the application when a call ends.
Recording Available Bandwidth API sends this to the application when a recording started by either a <StartRecording> or a <Record> verb is available for download.

Error Codes

Type Description
Rate Limits Every endpoint is rate limited
HTTP Errors Learn about the different errors that you may encounter using the API

results matching ""

    No results matching ""