Authenticated API v1

Message Status API

Retrieve the latest known status of an API-submitted message.

Important: Use the WebWMS2U message_id returned by the Send Message API. Do not use the provider message ID.

Endpoint

GET https://www.webwms2u.com/api/message-status.php?id=MESSAGE_ID

Authentication and ownership

Send the same active API key that originally submitted the message. A different key—including another key owned by the same account—cannot retrieve it. Unknown and unauthorized IDs both return 404 MESSAGE_NOT_FOUND to prevent information disclosure.

cURL example

curl --request GET \
  'https://www.webwms2u.com/api/message-status.php?id=128047' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'X-API-Version: 1' \
  --header 'Accept: application/json'

If your server does not forward the Authorization header, use X-API-KEY: YOUR_API_KEY.

PHP example

<?php
$messageId = 128047;
$apiKey = 'YOUR_API_KEY';
$url = 'https://www.webwms2u.com/api/message-status.php?id=' . $messageId;

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'X-API-Version: 1',
        'Accept: application/json'
    ]
]);
$response = curl_exec($ch);
$httpStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $response;
?>

Successful response

{
  "success": true,
  "data": {
    "message_id": 128047,
    "status": "submitted",
    "channel": "personal",
    "to": "60123456789",
    "message_type": "text",
    "provider_message_id": "3EB0...",
    "credits_charged": 1,
    "credits_refunded": 0,
    "error_code": null,
    "error_message": null,
    "retryable": false,
    "created_at": "2026-08-11 09:56:56",
    "scheduled_at": "2026-08-11 09:56:56",
    "processed_at": "2026-08-11 09:56:57",
    "last_attempt_at": "2026-08-11 09:56:56"
  }
}

Status meanings

StatusMeaning
pendingWaiting to be processed or until its scheduled time.
processingA worker is processing the message.
submittedAccepted by the connected provider/device; this is not final delivery.
sentReported as sent by the messaging channel.
deliveredReported as delivered to the recipient.
readReported as read, when read receipts are available.
failedProcessing failed; inspect the returned error fields.
blockedBlocked by an applicable account, recipient or platform rule.
Polling guidance: Do not request status continuously. Use reasonable intervals and stop after a final status. For automatic updates, use Status Webhooks.