Skip to main content
Get Message Status

Get Message Status

Retrieve the delivery status and details of a specific SMS message using its message ID.

Parameters

string
required
Your API key for authentication
string
required
Your client identifier for authentication
string
required
Message ID of the SMS to check (obtained from send response)

Response

number
Error code (0 for success)
string
Description of the result
object
Message status details
string
Mobile number that received the message
string
Sender ID used for the message
string
Original message content
string
Date and time when message was submitted
string
Unique message identifier
string
Date and time when message was processed
string
Current delivery status

Success Response

Error Response

Message Status Values

Use Cases

  • Delivery confirmation: Check if a specific message was delivered
  • Customer support: Help customers track their message status
  • Analytics: Monitor delivery success rates
  • Debugging: Troubleshoot delivery issues
  • Compliance: Maintain delivery logs for regulatory requirements

Best Practices

  1. Store Message IDs: Always store message IDs returned from send operations
  2. Polling: Check status periodically for important messages
  3. Error handling: Handle different status values appropriately
  4. Timeouts: Set reasonable timeouts for status checks