Try the API Explorer
SMS Verify API
Anonymous SMS API
Voice Verify API
Phone Numbers API
Score API
Get Status API

Get Started with the Completion API

The Completion API is a lightweight API that is ideal for submitting completion rate information on high volumes of transactions. Completion rate information for a transaction is a way of telling TeleSign that you received a voice or SMS message, indicating that the transaction was completed. Providing this information allows TeleSign to monitor route quality and provide the fastest, most high quality routes for your messages.

The Completion API allows you to inform TeleSign that a transaction completed without providing a verification code, which is required when using the Get Status API to provide completion data. Unlike the Get Status API, responses from the Completion API provide information about completion status only. If you want detailed status information about your transactions, you should continue using the Get Status API.

The Completion API is discussed in the following sections:

General Information

All requests submitted for the Completion API:

  • Can be authenticated with Basic (easiest to implement) and Digest
  • Use as the base endpoint
  • Accept only UTF-8 encoded unicode characters as inputs
  • Use Content-Type application/x-www-form-urlencoded in request headers

Send Completion Data

For details about how to send completion data, refer to the Send Completion Data page.

If you want to review available parameters and responses for the Completion API, refer to the PUT /verify/completion page.

Completion API Examples


A PUT request to the Completion API looks like this:

Example Request
Accept-Encoding: gzip,deflate 
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:Uak4fcLTTH/Tv8c/Q6QMwl5t4ck= 
User-Agent: CERN-LineMode/2.15 libwww/2.17b3

The body of the response from the Completion API looks like this:

Example Response
  "reference_id": "ABCDEF0123456789ABCDEF0123456789",
  "sub_resource": "sms|voice|push|two_way_sms",
  "status": {
     "code": 1900,
     "updated_on": "2014-10-14T18:07:26.078515Z",
     "description": "Verify completion successfully recorded"

Next Steps

This section offers some suggestions for next steps to take.