...
The response is a JSON object with the following attributes:
| address | The device phone number |
| timestamp | Last location timestamp |
| latitude | Device network location latitude |
| longitude | Device network location longitude |
| altitude | Device network location altitude / elevation |
| accuracy | Device network location accuracy (in meters) |
Sample Call
curl --silent https://api.us.apiconnect.ibmcloud.com/tmforum-apidev/telustmfcatalog/telustmfapilocation/location/6045550000 \
-H "Content-type: application/json" \
-H "X-IBM-Client-Id: c466530c-8489-4353-8cac-6c0babe8ff40"
...
{
"address": "6045550000",
"timestamp": "Mon, 18 Sep 2017 03:39:36 +0000",
"latitude": "49.237774",
"longitude": "-123.017636",
"altitude": "22.0",
"accuracy": "182"
}Error Messages
| Client id is missing | Client credentials are missing (HTTP header X-IBM-Client-Id is missing) |
| Client id not registered | Client credentials are invalid (invalid value for HTTP header X-IBM-Client-Id) |
| Missing terminal address | Address / phone number parameter is missing |
| Terminal address not authorized | Address / phone number is not whitelisted for use by your application |
...
This service is to be used to retrieve the delivery status of an SMS message you previously sent.
REST API
Where {correlator} is the correlator ID returned from a successful SMS delivery API call.
...