# 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",
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smarthive-tech-solution.gitbook.io/smarthive-tech-solution-api/sms/callback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.