---
description: >-
  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.
---

# Status (V2)

You can choose to use your own generated ID that you've passed while sending the SMS which is the <mark style="color:green;">**ext\_msg\_id**</mark> or you can choose the use the ID from the API response when the SMS was sent.

## SMS Status Request

<mark style="color:green;">`POST`</mark> `https://app.sleengshort.com/api/sms/status/dlr`

```postman_json
{
    "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<mark style="color:red;">\*</mark> | String | Your API Key |

#### Request Body

| Name                                      | Type  | Description      |
| ----------------------------------------- | ----- | ---------------- |
| msg\_id<mark style="color:red;">\*</mark> | Array | Your message IDs |

{% tabs %}
{% tab title="200: OK " %}
The JSON response below demonstrates a sample response from the endpoint

```javascript
{
    "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.
{% endtab %}
{% endtabs %}



<table><thead><tr><th width="370.5">DLR Statuses</th><th>Description</th></tr></thead><tbody><tr><td>SUBMITED</td><td>SMS successfully submited to operator</td></tr><tr><td>DELIVRD</td><td>SMS successfully terminated</td></tr><tr><td>REJECTD</td><td>SMS rejected/blocked on operator firewall</td></tr><tr><td>UNDELIV</td><td>Operator unable to deliver SMS to the recipient(s)</td></tr><tr><td>EXPIRED</td><td>Operator unable to deliver SMS to the  recipient(s)</td></tr><tr><td>LOW FUNDS</td><td>Insufficient funds/SMS units in a client account</td></tr></tbody></table>



