Get Message Status API: SMS Delivery Status

Check the delivery status of sent SMS by message ID. Use to confirm delivery, pending, or failure for OTP and transactional messages.

You can subscribe to the webhook service here.

Request

{{baseUrl}}/api/v1/messaging/sms/get_status

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query Parameters

Parameters	Type	Description	Required
message_id	string	reference ID of the message	required

Response Sample

{
    "entity": {
        "status": "DELIVERED"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the message status result
entity.status	string	Current delivery status of the message (e.g., “DELIVERED”, “PENDING”, “FAILED”)