By passing the reference ID for a transaction in the body of your request, you can receive a response containing details about that transaction. NOTE: If you try this API out using the API Explorer, you will be billed for the transaction as you normally would.
All requests submitted for the Voice API:
Your request was fulfilled and resulted in a new resource being created. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response.
|Status Code||Associated Text String||Description|
|100||Call answered||The call was answered by the end user or voicemail.|
|101||Not answered||No one answered the call.|
|103||Call in progress||The call is currently happening.|
|104||Wrong/invalid phone number||The phone number is not correctly formatted in some way, so a call cannot be placed.|
|106||Call failed||The call did not go through. Typically this occurs when TeleSign’s upstream providers fail to complete the call. Sometimes retrying will work.|
|107||Line busy||The line was busy when the call tried to reach the end user’s device.|
|130||Call blocked by TeleSign||TeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.|
A 32-digit hex value used to identify the web service request. The value is unique to each web service request, is randomly generated by TeleSign, and is returned in the response message immediately following the web service request.
This code describes the status of your transaction. You can use this to programmatically respond. You are returned two types of codes, either status codes or error codes.
A text description of the status code.
This is a timestamp showing when your transaction status was updated last.
If the end user answers a voice call and presses on the keypad after the message plays, you will see this parameter and it will display whatever the end user pressed. If the end user presses multiple digits on the keypad, only the last digit is returned. Additionally, if the end user presses the keypad before the message completes, that information will not be recorded at all.
If you chose a caller id, this parameter comes back in the response and lists the caller_id that you chose.