Message Status

SMS V3 APIs - SMS Applications

The delivery status of one message this SMS application sent.

GEThttps://telcomw.com/api/v3/sms/ke4wz6fydbtj

Put the message_id in the URL. The API key of the SMS application goes in the X-API-Key header.

Parameters

Parameter Sent in Required Description
X-API-Key header YES The API key of the SMS application, sent as a header. It starts with tmwapp_ and is made in the dashboard, under SMS Applications. It is not your account API key.
message_id path YES The id of the message, from the send response or from Delivery Reports.

Example request

curl --location --request GET 'https://telcomw.com/api/v3/sms/ke4wz6fydbtj' \
  --header 'X-API-Key: YOUR_APPLICATION_KEY'
curl --location --request GET "https://telcomw.com/api/v3/sms/ke4wz6fydbtj" ^
  --header "X-API-Key: YOUR_APPLICATION_KEY"
<?php

$headers = [
    'X-API-Key: YOUR_APPLICATION_KEY',
];

$ch = curl_init('https://telcomw.com/api/v3/sms/ke4wz6fydbtj');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));
const axios = require('axios');

axios.request({
  method: 'get',
  url: 'https://telcomw.com/api/v3/sms/ke4wz6fydbtj',
  headers: {
    'X-API-Key': 'YOUR_APPLICATION_KEY'
  }
}).then((res) => console.log(res.data))
  .catch((err) => console.error(err.response ? err.response.data : err.message));
import requests

headers = {
    'X-API-Key': 'YOUR_APPLICATION_KEY'
}

response = requests.request('GET', 'https://telcomw.com/api/v3/sms/ke4wz6fydbtj', headers=headers)
print(response.json())

Response

The response is JSON.

Response (200)

{
  "success": true,
  "request_id": "req_5f2c9a1d0e7b4a63",
  "data": {
    "message_id": "ke4wz6fydbtj",
    "batch_id": "k3m9x2p7q1ab",
    "to": "265999123456",
    "sender_id": "WGIT",
    "message": "Our sale starts today. Visit us!",
    "status": "delivered",
    "sent_at": "2026-11-02T08:15:02.000Z",
    "delivered_at": "2026-11-02T08:15:09.000Z"
  }
}

No such message (404)

{
  "success": false,
  "request_id": "req_5f2c9a1d0e7b4a63",
  "error": {
    "code": "MESSAGE_NOT_FOUND",
    "message": "No message with this id on your account."
  }
}

Fields explained

FieldDescription
data.statuspending, delivered or failed.
data.delivered_atWhen it was delivered (UTC), null until then.

Good to know

  • A message that was not sent through this SMS application is answered with 404, as if it did not exist.