Status

The endpoint allows you to do multiple lookups at a time by passing an array of msg_id.

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

{

"msg_id": [

"<msg_id_value>",

"be6fe748-4748-41f9-b9bfee66d49bc79"

]

}

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

The JSON response below demonstrates a sample response from the endpoint

{ 
       "status": "ok", 
       "description": "Request processed successfully", 
       "data": { 
           "92428fef-6cc7-4269-926f-001d4a478328": "REJECTD", 
           "be6fe748-4748-41f9-b9b9-fee66d49bc79": "DELIVRD" 
                   } 
}
 

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

Last updated