Get SMS delivery status

GET https://www.lightsms.com/external/get/status.php

Check the delivery status of sent SMS messages.

Use this endpoint to track if your messages were successfully delivered to recipients. The status is updated in real-time as the SMS is processed by mobile carriers.

Authorization

This endpoint requires authentication using login, signature, and timestamp parameters.

See the Authentication documentation for more details.

Parameters

Query Parameters

Name	Type	Required	Description
login	string	✓	Your LightSMS account login
signature	string	✓	Request signature for authentication
timestamp	string	✓	UTC timestamp of the request
sms_id	string	✓	SMS message ID (received from send endpoint)
return	string		Response format (json or xml)

Example

Request

GET https://www.lightsms.com/external/get/status.php?login=JohnDoe&signature=abc123&sms_id=4092113103483809600001&timestamp=1761188934&return=json

Response

{
  "status": "delivered",
  "delivered_at": "2024-01-15 10:30:00"
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://www.lightsms.com

Query Parameters

loginREQUIRED

Your LightSMS account login

signatureREQUIRED

Request signature for authentication

stateREQUIRED

SMS ID(s). For multiple IDs, separate with commas

timestampREQUIRED

UTC timestamp of the request

return

Response format (json or xml)

RESPONSE

Status retrieved successfully

{
  "409129710034887330001": "not_deliver",
  "409129710034880230003": "not_deliver"
}