> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  You can subscribe to the webhook service [here](/docs/gettingstarted/subscribe-to-service).
</Note>

### Request

```text theme={null}
{{baseUrl}}/api/v1/messaging/sms/get_status
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| 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") |