# Callback

## Callback

<mark style="color:green;">`POST`</mark> `https://your-callback-url.com/`

If you specify a **callback\_url** when sending your message, we will perform a http request to the provided url with the following message status data.

#### Request Body

| Name        | Type   | Description                                                                                           |
| ----------- | ------ | ----------------------------------------------------------------------------------------------------- |
| status      | String | The final status of the message, in all-caps, ie. DELIVRD, UNDELIV, EXPIRED etc                       |
| msg\_id     | String | The unique message ID allocated to the message when originally submitted.                             |
| timestamp   | String | The date and time at which the sms message reached it's final state.                                  |
| cost        |        | The cost of sending this message.                                                                     |
| pg\_length  | String | Number of pages for the message. The character limit for a single page SMS message is 160 characters. |
| str\_length | int    | Total number of characters for the sms.                                                               |
| desc        | String | The description of the delivery status                                                                |
| dlr\_code   | String | The DLR status success or error code associated with the delivery status.                             |

{% tabs %}
{% tab title="200: OK " %}

```
{"status": "ok"}
```

{% endtab %}
{% endtabs %}

```
{
   "msg_id": "jyd823-23n",
   "status": "DELIVRD",
   "dlr_code": "err:000",
   "timestamp": "202311042057",
   "str_length": "157",
   "pg_length": "1",
   "cost": "3.00",
   "desc": "DELIVERED",
}
```