start_mt_session

The start_mt_session call is used to initiate a MT USSD session ("push" USSD). This feature is network-dependant.

URL: https://tms.flashmedia.co.za/api/ussd/start_mt_session

HTTP Method: POST

Input Parameters

destination
Comma-separated list of destination MSISDNs.
application_id
The application ID of the registered TMS3 application that will handle the resulting USSD session(s).

Data Returned

started
Whether or not the USSD session(s) were initiated. Possible values are true and false.
error
(Optional) A string describing the error in case "started" was "false". Not included in response if "started" is "true".

Example API call using cURL

JSON

curl -X POST https://tms.flashmedia.co.za/api/ussd/start_mt_session \
-u 'username:password' -H 'Accept: application/json' \
-d 'destination=27820000001,27790000222,27820000333,27830004444'

Example Successful Response

{
  "accepted" : true
}