An Application is a set of Answer, Hangup, and Message URLs that help you control your incoming calls and messages.

​
API Endpoint

BaseURI
https://api.plivo.com/v1/Account/{auth_id}/Application/

​
Answer URL

Plivo requests this URL for a valid Plivo XML element on an incoming call. The XML returned by this URL determines the flow of the call. For example, if you want to play a message on an incoming call to a Plivo number, the URL must return the XML as shown in the example response. Plivo requests the Answer URL with the following parameters:

​
Parameters Plivo sends to the Answer URL

NameTypeDescription
CallUUIDstringA unique identifier for this call.
FromstringThe phone number of the party that initiated the call along with the country code. For inbound calls, this is the caller’s caller ID. For outbound calls, this is the caller ID specified in the API request.
TostringThe phone number of the called party with the country code. For inbound calls, this is your Plivo number. For outbound calls, this is the destination number provided in the API request.
ForwardedFromstringSet only when the call received by Plivo is a forwarded call. Its value depends on the caller’s carrier and may not always be present.
CallStatusstringIndicates the call’s status: ringing, in-progress, or completed. For outbound calls, it may also be busy, failed, timeout, or no-answer.
DirectionstringIndicates the direction of the call. Typically inbound for incoming calls and outbound for calls made using the Call API.
ALegUUIDstringA unique identifier for the first leg of the call in outbound scenarios. Not present for inbound calls.
ALegRequestUUIDstringA unique request identifier returned by Plivo for an outbound call initiated via API. Not present for inbound calls.

​
Hangup URL

Plivo will make an HTTP request to this URL when the call is hung up. The following parameters will be sent to the Hangup URL:

​
Parameters Plivo sends to the Hangup URL

NameTypeDescription
CallUUIDstringA unique identifier for this call.
FromstringThe phone number of the party that initiated the call with the country code. For inbound calls, this is the caller’s caller ID. For outbound calls, it’s the caller ID specified in the API request.
TostringThe phone number of the called party with the country code. For inbound calls, it’s your Plivo number. For outbound calls, it’s the destination number provided.
ForwardedFromstringSet only when the call received by Plivo is a forwarded call. Its value depends on the caller’s carrier and may not always be present.
CallStatusstringIndicates the call status: ringing, in-progress, or completed. For outbound calls, may also be busy, failed, timeout, or no-answer.
DirectionstringIndicates call direction. Typically inbound (ringing state) or outbound (answered state via API).
ALegUUIDstringUnique identifier for the first leg of an outbound call. Not present for inbound calls.
ALegRequestUUIDstringUnique request identifier for an outbound call initiated via API. Not present for inbound calls.
DurationstringDuration of the call in seconds.
BillDurationstringBilled duration of the call in seconds.
HangupCauseNamestringReason for the call hangup. See this guide for more details.
HangupCauseCodeintegerUnique code representing the hangup cause. See this guide for the full list.
HangupSourcestringEntity that triggered the hangup. Possible values: Caller, Callee, Plivo, API Request, Answer XML, Error, Unknown. More info in this guide.

​
Message URL

Plivo will send all incoming messages to this URL. We expect to receive a HTTP status code of 200 from this URL. If a non 200 code is returned, we would keep retrying this URL once every 5 minutes for the first hour and then once every hour for 24 hours. Plivo will drop the message after 24 hours of receiving non 200 codes. The following parameters will be sent to the Message URL.

​
Parameters Plivo sends to the Message URL

NameTypeDescription
FromstringThe source number of the incoming message. This will be the number of the person sending a message to a Plivo number.
TostringThe number to which the message was sent. This will the your Plivo number on which the message has been received.
TypestringType of the message. This will always be sms.
TextstringThe content of the message.
MessageUUIDstringA unique ID for the message. Your message can be uniquely identified on Plivo by this ID.

​
Response

<Response>
    <Speak>Hello, thanks for call</Speak>
</Response>