Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Call

A Call is an object that represents a connection between a telephone and Twilio.

Using this resource, you can initiate a call, fetch information about a completed call, fetch a list of calls made to and from your account, redirect or end a call that is in progress, and delete records of past calls from your account.

An inbound call occurs when a person calls one of your Twilio phone numbers, client connections, or SIP-enabled endpoints. An outbound call happens when you initiate a call from a Twilio phone number to an outside phone number, client, or SIP domain.

You can initiate an outbound call by POSTing to the Call resource, creating a new call.

You can also initiate a call from an active call (e.g., forwarding to another number or dialing into a conference) by including TwiML's <Dial> verb in your TwiML application. However, the only way to initiate a call directly from Twilio is with an API request.

Are you looking for step-by-step instructions for making your first call with Twilio using the helper libraries? Check out one of our quickstarts in your programming language of choice: C#/.NET, Java, Node.js, PHP, Python, or Ruby.

Call properties

account_sid
sid<AC> Not PII

The unique id of the Account responsible for creating this Call.

annotation
string Not PII

The annotation provided for the Call

answered_by
string Not PII

Either human or machine if this Call was initiated with answering machine detection. Empty otherwise.

api_version
string Not PII

The API Version used to create the Call

caller_name

The caller's name if this Call was an incoming call to a phone number with Caller ID Lookup enabled. Empty otherwise.

date_created
date_time<rfc2822> Not PII

The date that this resource was created, given as GMT in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date that this resource was last updated, given as GMT in RFC 2822 format.

direction
string Not PII

A string describing the direction of the Call. Values are inbound for inbound calls, outbound-api for calls initiated via the REST API or outbound-dial for calls initiated by a <Dial> verb. Using Elastic SIP Trunking, the values can be trunking-terminating for outgoing calls from your communications infrastructure to the PSTN or trunking-originating for incoming calls to your communications infrastructure from the PSTN.

duration
string Not PII

The length of the Call in seconds. This value is empty for busy, failed, unanswered or ongoing calls.

end_time
date_time<rfc2822> Not PII

The time the Call ended, given as GMT in RFC 2822 format. Empty if the call did not complete successfully.

forwarded_from

The forwarding phone number if this Call was an incoming call forwarded from another number (depends on carrier supporting forwarding). Empty otherwise.

from

The phone number, SIP address, Client identifier or SIM SID that made this Call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name. SIM SIDs are formatted as sim:sid.

from_formatted

The phone number, SIP address or Client identifier that made this Call. Formatted for display.

group_sid
sid<GP> Not PII

A 34-character Group Sid associated with this Call. Empty if no Group is associated with the Call.

parent_call_sid
sid<CA> Not PII

A 34-character string that uniquely identifies the Call that created this leg.

phone_number_sid
sid<PN> Not PII

If the call was inbound, this is the Sid of the IncomingPhoneNumber that received the call. If the call was outbound, it is the Sid of the OutgoingCallerId from which the call was placed.

price
decimal Not PII

The charge for this Call, in the currency associated with the account. Populated after the call is completed. May not be immediately available.

price_unit
currency Not PII

The currency in which Price is measured, in ISO 4127 format (e.g., USD, EUR, JPY). Always capitalized for calls.

sid
sid<CA> Not PII

A 34-character string that uniquely identifies the Call resource.

start_time
date_time<rfc2822> Not PII

The start time of the call, given as GMT in RFC 2822 format. Empty if the call has not yet been dialed.

status
enum:status Not PII

A string representing the status of the Call. May be queued, ringing, in-progress, canceled, completed, failed, busy or no-answer. See Call Status Values below for more information.

subresource_uris
uri_map Not PII

A Map of various subresources available for the given Call Instance

to

The phone number, SIP address, Client identifier or SIM SID that received this Call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name. SIM SIDs are formatted as sim:sid.

to_formatted

The phone number, SIP address or Client identifier that received this Call. Formatted for display.

uri
uri Not PII

The URI for this resource, relative to https://api.twilio.com

Call status values

The following are the possible values for the Status parameter:

Status Description
queued The call is ready and waiting in line before dialing.
ringing The call is currently ringing.
in-progress The call was answered and is currently in progress.
canceled The call was hung up while it was queued or ringing.
completed The call was answered and has ended normally.
busy The caller received a busy signal.
failed The call could not be completed as dialed, most likely because the phone number was non-existent.

Create a Call resource

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json

Calls can be made via the REST API to phone numbers, SIP addresses, or client identifiers. To place a new outbound call, make an HTTP POST request to your account's Call resource.

A wireless SIM SID is an invalid value in the to and from properties when creating an outbound call via the REST API. If you'd like to dial a wireless SIM, use TwiML's <Dial> verb with the <Sim> noun. Check out our guide on how to make and receive calls with a wireless device for more information.

Parameters
ApplicationSid
Required if Url is not passed
post sid<AP> Not PII

The 34-character SID of the application Twilio should use to handle this phone call. If this parameter is present, Twilio will ignore all of the voice URLs passed and use the URLs set on the application. See the ApplicationSid Parameter section in Making Calls for more details.

From
Required
post phone_number Not PII

The phone number or client identifier to use as the caller id. If using a phone number, it must be a Twilio number or a Verified outgoing caller id for your account. If the To parameter is a phone number, From must also be a phone number.

To
Required
post endpoint Not PII

The phone number, SIP address, or client identifier to call.

Url
Required if ApplicationSid is not passed
post url Not PII

The fully qualified URL that hosts instructions for the call. Twilio will consult this URL when the call connects. See the Url Parameter details in Making Calls for more details.

CallerId
Optional
post string Not PII

The phone number, SIP address, or Client identifier that made this Call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com.

FallbackMethod
Optional
post http_method Not PII

The HTTP method that Twilio should use to request the FallbackUrl. Must be either GET or POST. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

FallbackUrl
Optional
post url Not PII

A URL that Twilio will request if an error occurs requesting or executing the TwiML at Url. If an ApplicationSid parameter is present, this parameter is ignored.

MachineDetection
Optional
post string Not PII

Detect if a human, answering machine, or fax has picked up the call. Use Enable if you would like Twilio to return an AnsweredBy value as soon as it identifies the called party. If you would like to leave a message on an answering machine, specify DetectMessageEnd. If both SendDigits and MachineDetection parameters are provided, then MachineDetection will be ignored. Detailed documentation is here.

MachineDetectionTimeout
Optional
post integer Not PII

The number of seconds that Twilio should attempt to perform answering machine detection before timing out and firing a voice request with AnsweredBy of unknown. Defaults to 30 seconds.

Method
Optional
post http_method Not PII

The HTTP method Twilio should use when making its request to the Url parameter's value. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

Record
Optional
post boolean Not PII

Set this parameter to true to record the entirety of a phone call. The RecordingUrl will be sent to the StatusCallback URL. Defaults to false.

RecordingChannels
Optional
post string Not PII

mono or dual – defaults to mono. Set this parameter to specify the number of channels in the final recording. In a mono-channel recording, both legs of the call are mixed down into a single channel within a single recording file. With dual-channel recording, both legs use separate channels within a single recording file. In dual-channel recordings, the parent call will always be in the first channel, and the child call will always be in the second channel.

RecordingStatusCallback
Optional
post string Not PII

A URL that Twilio will send a webhook request to when the recording is available for access.

RecordingStatusCallbackEvent
Optional
post string[] Not PII

The recording status events that will trigger Twilio to send webhooks on to the URL specified in RecordingStatusCallback. The available values are in-progress, completed, and failed. Defaults are completed and failed. To specify multiple values, separate them with a space. If any values are specified, the defaults are no longer applicable.

RecordingStatusCallbackMethod
Optional
post http_method Not PII

The HTTP method Twilio should use when requesting the RecordingStatusCallback URL. Defaults to POST.

SendDigits
Optional
post string Not PII

A string of keys to dial after connecting to the number, maximum of 32 digits. Valid digits in the string include: any digit (0-9), '#', '*' and 'w' (to insert a half second pause). For example, if you connected to a company phone number and wanted to pause for one second, dial extension 1234, and then the pound key, use SendDigits=ww1234#. Remember to URL-encode this string, since the '#' character has special meaning in a URL. If both SendDigits and MachineDetection parameters are provided, then MachineDetection will be ignored.

StatusCallback
Optional
post url Not PII

A URL that Twilio will send asynchronous webhook requests to on every call event specified in the StatusCallbackEvent parameter. If no event is specified, Twilio will send completed by default. If an ApplicationSid parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).

StatusCallbackEvent
Optional
post string[] Not PII

The call progress events that will trigger a webhook from Twilio. Available values are initiated, ringing, answered, and completed. If no event is specified, defaults to completed. If you want to receive multiple events, please provide multiple StatusCallbackEvent values as individual parameters in the POST request. See the code sample for monitoring call progress. If an ApplicationSid is present, this parameter is ignored.

StatusCallbackMethod
Optional
post http_method Not PII

The HTTP method Twilio should use when requesting the StatusCallback URL. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

Timeout
Optional
post integer Not PII

The integer number of seconds that Twilio should allow the phone to ring before assuming there is no answer. Default is 60 seconds, the maximum is 600 seconds. For some call flows, Twilio will add a 5-second buffer to the timeout value provided, so if you enter a timeout value of 10 seconds, you could see actual timeout closer to 15 seconds. Note, you could set this to a low value like 15 to hang up before reaching an answering machine or voicemail.

Trim
Optional
post string Not PII

trim-silence or do-not-trim. Set this parameter to define whether leading and trailing silence is trimmed from the recording. Defaults to trim-silence.

Example 1
Loading Code Sample...
      
      
      
      
      Twilio will make a synchronous request to the URL specified to retrieve instructions on how to handle the call.

      Create a Call

      Twilio will make a synchronous request to the URL specified to retrieve instructions on how to handle the call.
      Example 2
      Loading Code Sample...
          
          
          
          
          This example sets a StatusCallback so that Twilio can return information about the call to the specified URL.

          Create a Call and specify a StatusCallback URL

          This example sets a StatusCallback so that Twilio can return information about the call to the specified URL.
          Example 3
          Loading Code Sample...
              
              
              
              
              This example places a call and requests a callback when the call is initiated.

              Create a Call and specify a StatusCallbackEvent

              This example places a call and requests a callback when the call is initiated.

              StatusCallback

              After completing an outbound call, Twilio will make an asynchronous HTTP request to the StatusCallback URL you specified in your request (if any).

              Parameters sent to your StatusCallback URL

              When Twilio sends its asynchronous request to your StatusCallback URL, it includes all of the following parameters:

              Parameter Description
              CallSid A unique identifier for this call, generated by Twilio.
              AccountSid Your Twilio account ID. It is 34 characters long, and always starts with the letters 'AC'
              From

              The phone number or client identifier of the party that initiated the call.

              Phone numbers use E.164 formatting, meaning they start with a '+' and country code, e.g. +16175551212.
              Client identifiers begin with the client: URI scheme; for example, on a call from a client named 'charlie' the From parameter will be client:charlie.

              To

              The phone number or client identifier of the called party.

              Phone numbers use E.164 formatting, meaning they start with a '+' and country code, e.g. +16175551212.

              Client identifiers begin with the client: URI scheme; for example, for a call to a client named 'joey', the To parameter will be client:joey.

              CallStatus

              A descriptive status for the call.

              The value is one of the following: queued, ringing, in-progress, completed, busy, failed or no-answer.

              ApiVersion

              The version of the Twilio API used to handle this call.

              For incoming calls, this is determined by the API version set on the dialed number.

              For outgoing calls, this is the version used in the REST API request of the outgoing call.

              Direction

              A string describing the direction of the call:

              inbound for inbound calls

              outbound-api for calls initiated via the REST API

              outbound-dial for calls initiated by a <Dial> verb.

              ForwardedFrom

              This parameter is only set when Twilio receives a forwarded call. Its value depends on the carrier including this information when forwarding the call.

              Not all carriers support passing this information.

              CallerName This parameter is set when the IncomingPhoneNumber that received the call has set its VoiceCallerIdLookup value to true ($0.01 per lookup).
              ParentCallSid

              A unique identifier for the call that created this leg.

              If this is the first leg of a call, this parameter is not included.

              StatusCallbackEvent

              If you specify any call progress events in the StatusCallbackEvent parameter, Twilio will make an asynchronous request to the StatusCallback URL you provided in your POST request.

              The call progress events you can specify are:

              Event Description
              initiated Twilio removes your call from the queue and starts dialing
              ringing The call starts ringing
              answered The call is answered
              completed The call is completed, regardless of the termination status (which can be busy, cancelled, completed, failed, or no-answer). If no StatusCallbackEvent is specified, completed is fired by default.

              When these events occur, Twilio's StatusCallback request will also include these additional parameters:

              Parameter Description
              CallStatus A descriptive status for the call. The value is one of queued, initiated, ringing, in-progress, busy, failed, or no-answer. For more details, see the CallStatus values in our TwiML introduction.
              CallDuration The duration in seconds of the just-completed call. Only present in the completed event.
              SipResponseCode The SIP code that resulted in a failed call.
              For instance, a number that was unreachable will return 404, and if the Timeout value was reached before the call connected this code will be 487.
              Only present in the completed event if the CallStatus is failed or no-answer.
              RecordingUrl The URL of the phone call's recorded audio.
              This parameter is included only if Record=true is set on the REST API request and does not include recordings initiated in other ways. RecordingUrl is only present in the completed event.
              The recording file may not yet be accessible when the Status Callback is sent. Note: Use RecordingStatusCallback for reliable notification on when the recording is available for access.
              RecordingSid The unique ID of the Recording from this call. RecordingSid is only present with the completed event.
              RecordingDuration The duration of the recorded audio (in seconds). RecordingDuration is only present in the completed event. To get a final accurate recording duration after any trimming of silence, use RecordingStatusCallback.
              Timestamp The timestamp when the event fired, given as UTC in RFC 2822 format.
              CallbackSource A string that describes the source of the webhook. This is provided to help disambiguate why the webhook was made. On Status Callbacks, this value is always call-progress-events.
              SequenceNumber The order in which the events were fired, starting from 0. Although events are fired in order, they are made as separate HTTP requests, and there is no guarantee they will arrive in the same order.

              To learn more about the StatusCallbackEvent parameter and what you can expect from Twilio during and after an outbound call, check out our overview page on making outbound calls.

              RecordingStatusCallback

              If you requested a recording of your outbound call and you specified a RecordingStatusCallback URL, Twilio will make a GET or POST request to that URL when the recording is available.

              Twilio will pass along the following parameters to your RecordingStatusCallback URL:

              Parameter Description
              AccountSid The unique identifier of the Account responsible for this recording.
              CallSid A unique identifier for the call associated with the recording. CallSid will always refer to the parent leg of a two-leg call.
              RecordingSid The unique identifier for the recording.
              RecordingUrl The URL of the recorded audio.
              RecordingStatus The status of the recording. Possible values are: in-progress, completed, failed.
              RecordingDuration The length of the recording, in seconds.
              RecordingChannels The number of channels in the final recording file as an integer. Possible values are 1, 2.
              RecordingStartTime The timestamp of when the recording started.
              RecordingSource The initiation method used to create this recording. For recordings initiated when Record=true is set on the REST API, OutboundAPI will be returned.

              RecordingStatusCallbackEvent

              Just as you can specify call progress events with StatusCallbackEvent, you can also specify which recording status changes should trigger a callback to your application.

              Available recording status values are:

              Parameter Description
              in-progress The recording has started
              completed The recording is complete and available for access
              failed The recording is not available due to a failure

              This parameter defaults to completed and failed. To specify multiple values, separate them with a space. If any values are specified, the defaults are no longer applicable.

              To pause, resume, or stop recordings, see the Recording API Docs.

              Fetch a Call resource

              get
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

              This API call returns the Call resource of an individual call, identified by its CallSid. This resource is eventually consistent.

              To get real-time call status updates, we recommend using the StatusCallbackEvent on the Outbound API request or the TwiML <Dial> verb statusCallbackEvent attribute for the case of child calls.

              Parameters
              Sid
              Required
              get sid<CA> Not PII

              The Call Sid that uniquely identifies the Call to fetch

              Example 1
              Loading Code Sample...
                  
                  
                  
                  
                  Get a specific Call, as specified by it's unique identifier (CallSid)

                  Fetch a Call

                  Get a specific Call, as specified by it's unique identifier (CallSid)

                  Call Recordings

                  You can access the Recordings list subresource on any given Call.

                  The following will return a list of all of the recordings generated with a given call (identified by its CallSid):

                  /2010-04-01/Accounts/{YourAccountSid}/Calls/{CallSid}/Recordings
                  

                  See the Recordings reference documentation for resource properties and response formats.

                  Call Feedback

                  You can access call quality feedback information from a given phone call by requesting the Feedback subresource on any Call (identified by its CallSid):

                  /2010-04-01/Accounts/{YourAccountSid}/Calls/{CallSid}/Feedback
                  

                  See the Call Quality Feedback reference documentation for resource properties and response formats.

                  Read multiple Call resources

                  get
                  https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json

                  Return a list of phone calls made to and from an account, identified by its AccountSid.

                  The following query string parameters allow you to filter and limit the list returned to you by the REST API. Note: these parameters are case-sensitive.

                  Parameters
                  EndTime
                  Optional
                  get date_time_inequality<iso8601> Not PII

                  Only show calls that ended on this date

                  From
                  Optional
                  get phone_number Not PII

                  Only show calls from this phone number, SIP address, Client identifier or SIM SID.

                  ParentCallSid
                  Optional
                  get sid<CA> Not PII

                  Only show calls spawned by the Call with this SID.

                  StartTime
                  Optional
                  get date_time_inequality<iso8601> Not PII

                  Only show calls that started on this date, given as YYYY-MM-DD. Also supports inequalities, such as StartTime<=YYYY-MM-DD for calls that started at or before midnight on a date, and StartTime>=YYYY-MM-DD for calls that started at or after midnight on a date.

                  Status
                  Optional
                  get enum:status Not PII

                  Only show calls currently in the specified status. May be queued, ringing, in-progress, canceled, completed, failed, busy, or no-answer.

                  To
                  Optional
                  get phone_number Not PII

                  Only show calls to this phone number, SIP address, Client identifier or SIM SID.

                  Example 1
                  Loading Code Sample...
                      
                      
                      
                      
                      Get a list of all calls that were placed or received by your Twilio account

                      Read calls

                      Get a list of all calls that were placed or received by your Twilio account
                      Example 2
                      Loading Code Sample...
                          
                          
                          
                          
                          Filters the call list to return completed calls started on Jul 6th, 2009

                          Read calls (filter by start date)

                          Filters the call list to return completed calls started on Jul 6th, 2009
                          Example 3
                          Loading Code Sample...
                              
                              
                              
                              
                              Filters the call list to return completed calls started on or after midnight Jul 6th, 2009

                              Read calls (filter by 'after start' date)

                              Filters the call list to return completed calls started on or after midnight Jul 6th, 2009
                              Example 4
                              Loading Code Sample...
                                  
                                  
                                  
                                  
                                  Filters the call list to return completed calls that started between midnight Jul 4th, 2009 and midnight Jul 6th, 2009.

                                  Read calls (filter by a period of time)

                                  Filters the call list to return completed calls that started between midnight Jul 4th, 2009 and midnight Jul 6th, 2009.
                                  Example 5
                                  Loading Code Sample...
                                      
                                      
                                      
                                      
                                      Filters the call list to return calls with the status of 'busy' that were made with the specified 'To' number

                                      Read calls (filter by call status and phone number)

                                      Filters the call list to return calls with the status of 'busy' that were made with the specified 'To' number
                                      Example 6
                                      Loading Code Sample...
                                          
                                          
                                          
                                          
                                          Filters the call list to return calls that were made from a Twilio Client device named 'charlie'.

                                          Read calls (filter by calls from a specific device)

                                          Filters the call list to return calls that were made from a Twilio Client device named 'charlie'.

                                          A note on representation:

                                          You can append a '.csv' extension to any resource URI to get CSV (Comma Separated Values) representation. Specifying CSV may be especially useful for call logs. Try this:

                                          GET /2010-04-01/Accounts/{AccountSid}/Calls.csv

                                          Read the guide to Returning JSON, CSV, and HTML for more information about all available alternate representations.

                                          Paging

                                          The list returned to you with this API call includes paging information.

                                          If you plan to request more records than will fit on a single page, you can use the provided nextpageuri rather than incrementing through pages by page number.

                                          Using nextpaguri for paging ensures that your next request will pick up where you left off – this can help keep you from retrieving duplicate data if you are actively making or receiving calls.

                                          Update a Call resource

                                          post
                                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

                                          Updating a Call allows you to modify an active call.

                                          Real-time call modification allows you to interrupt an in-progress call and terminate it or have it begin processing TwiML from a new URL. Call modification is useful for any application where you want to change the behavior of a running call asynchronously, e.g., hold music, call queues, transferring calls, or forcing a hangup.

                                          By POSTing to a specific Call instance, you can redirect a call that is in progress or you can terminate a call.

                                          For step-by-step guidance on modifying in-progress calls, check out the tutorial Modify Calls in Progress in your web language of choice.

                                          Parameters
                                          Sid
                                          Required
                                          post sid<CA> Not PII

                                          The Call Sid that uniquely identifies the Call to update

                                          FallbackMethod
                                          Optional
                                          post http_method Not PII

                                          The HTTP method that Twilio should use to request the FallbackUrl. Must be either GET or POST. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

                                          FallbackUrl
                                          Optional
                                          post url Not PII

                                          A URL that Twilio will request if an error occurs when requesting or executing the TwiML at Url. If an ApplicationSid parameter is present, this parameter is ignored.

                                          Method
                                          Optional
                                          post http_method Not PII

                                          The HTTP method Twilio should use when making its request to the Url parameter's value. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

                                          Status
                                          Optional
                                          post enum:update_status Not PII

                                          Either canceled or completed. Specifying canceled will attempt to hang up calls that are queued or ringing, but will not affect calls already in progress. Specifying completed will attempt to hang up a call even if it's already in progress.

                                          StatusCallback
                                          Optional
                                          post url Not PII

                                          A URL that Twilio will send asynchronous webhook requests to on every call event specified in the StatusCallbackEvent parameter. If no event is specified, Twilio will send completed by default. If an ApplicationSid parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).

                                          StatusCallbackMethod
                                          Optional
                                          post http_method Not PII

                                          The HTTP method Twilio should use when requesting the StatusCallback URL. Defaults to POST. If an ApplicationSid parameter is present, this parameter is ignored.

                                          Url
                                          Optional
                                          post url Not PII

                                          that hosts instructions for the call. Twilio will consult this URL when the call connects. See the Url Parameter section in Making Calls for more details.

                                          Example 1
                                          Loading Code Sample...
                                              
                                              
                                              
                                              
                                              Redirect a call in progress by POSTing to the Call, setting the new destination in the code hosted at the URL parameter

                                              Update a call (redirect)

                                              Redirect a call in progress by POSTing to the Call, setting the new destination in the code hosted at the URL parameter
                                              Example 2
                                              Loading Code Sample...
                                                  
                                                  
                                                  
                                                  
                                                  End a call in progress by POSTing to the Call, specifying the status to 'completed'

                                                  Update a call (terminate)

                                                  End a call in progress by POSTing to the Call, specifying the status to 'completed'

                                                  When you redirect an active call to another phone number, Twilio creates an entirely new Call instance for that new phone number. The original call is the parent call, and any additional number dialed establishes a child call. Parent and child calls will have uniquely identifying Call SIDs.

                                                  Note that any parent call currently executing a <Dial> is considered in-progress by Twilio. Even if you've re-directed your initial call to a new number, the parent call is still active, and thus you must use Status=completed to end it.

                                                  Unanswered child calls cannot be canceled via the REST API, but the parent call can be modified to point to new TwiML. This action will end the child call.

                                                  Delete a Call resource

                                                  delete
                                                  https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

                                                  This will delete a call record from your account. Once the record is deleted, it will no longer appear in the API and Account Portal logs.

                                                  If successful, this DELETE returns an HTTP 204 (No Content) with no body.

                                                  Note that an error will occur if you attempt to remove a call record for a call that is actively in progress.

                                                  Parameters
                                                  Sid
                                                  Required
                                                  delete sid<CA> Not PII

                                                  The Call Sid that uniquely identifies the Call to delete

                                                  Example 1
                                                  Loading Code Sample...
                                                      
                                                      
                                                      
                                                      

                                                      Need some help?

                                                      We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

                                                      Loading Code Sample...