Status (V2)

This endpoint is a separate resource from the standard status check. Both allow multiple msg_id lookups, but this one returns extra details via live callback.

You can choose to use your own generated ID that you've passed while sending the SMS which is the ext_msg_id or you can choose the use the ID from the API response when the SMS was sent.

SMS Status Request

POST https://app.sleengshort.com/api/sms/status/dlr

{
    "msg_id":[
        "<msg_id_value>",
        "ce5cc6f6-5d1b-4f95-804d-76b40bfb8036-0"
    ]
    OR
    // "msg_id":[
    //     "<ext_msg_id_value>",
    //     "22222994949494923",
    // ]
}

Query Parameters

Name	Type	Description
ext_msg_id	String	This field should be empty

Headers

Name	Type	Description
X-Api-Key*	String	Your API Key

Request Body

Name	Type	Description
msg_id*	Array	Your message IDs

200: OK

The JSON response below demonstrates a sample response from the endpoint

{
    "status": "ok",
    "description": "Request processed successfully",
    "data": {
        "ce5cc6f6-5d1b-4f95-804d-76b40bfb8036-0": {
            "status": "DELIVRD",
            "msg_id": "ce5cc6f6-5d1b-4f95-804d-76b40bfb8036-0",
            "timestamp": "202508251738",
            "operator": "MTN - NG",
            "cost": "3.00",
            "pg_length": "1",
            "str_length": 27,
            "desc": "DELIVERED"
        }
    }
}

NB: To receive DLR automatically, add a callback URL on the Settings-> API Keys page of your Sleengshort account.

DLR Statuses	Description
SUBMITED	SMS successfully submited to operator
DELIVRD	SMS successfully terminated
REJECTD	SMS rejected/blocked on operator firewall
UNDELIV	Operator unable to deliver SMS to the recipient(s)
EXPIRED	Operator unable to deliver SMS to the recipient(s)
LOW FUNDS	Insufficient funds/SMS units in a client account