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

# Delivery reports

> Retrieve SMS delivery status using the Delivery Reports API.

Delivery reports let you check whether a message was delivered, is still pending, or could not be delivered.

<Info>
  Check delivery status **at least 5 minutes** after sending an SMS. Mobile network operators need time to return delivery updates to Beem.
</Info>

## How it works

1. Send an SMS using [Send SMS](/api-reference/sms/send-sms).
2. Note the `request_id` returned for each recipient in the response.
3. After at least 5 minutes, call **Get delivery reports** with `dest_addr` and `request_id`.

## API reference

Use the interactive API reference to try the request:

**[Get delivery reports](/api-reference/sms/get-delivery-reports)** — `GET https://dlrapi.beem.africa/public/v1/delivery-reports`

### Query parameters

| Parameter    | Description                                               |
| ------------ | --------------------------------------------------------- |
| `dest_addr`  | Destination mobile number (same format as when sending).  |
| `request_id` | Request ID from the Send SMS response for that recipient. |

### Status values

| Status        | Meaning                               |
| ------------- | ------------------------------------- |
| `PENDING`     | Delivery is still in progress.        |
| `DELIVERED`   | Message was delivered to the handset. |
| `UNDELIVERED` | Message could not be delivered.       |

### Authentication

Authenticate with **Basic Auth** (API Key and Secret) or an **access token**. See [Authentication](/guides/sms/authentication).

Set `Content-Type` to `application/json` for JSON requests or `application/xml` for XML requests.

## Sample response

```json theme={null}
[
  {
    "dest_addr": "255700000002",
    "status": "PENDING",
    "request_id": "31951"
  }
]
```

## Error responses

| HTTP status | When                                                                      |
| ----------- | ------------------------------------------------------------------------- |
| `404`       | Invalid `request_id` or `dest_addr` — no matching delivery report.        |
| `401`       | Invalid API credentials — see [API responses](/guides/sms/api-responses). |
| `400`       | Missing authorization header or invalid request.                          |

## Related

* [Sending flow](/guides/sms/sending-flow) — end-to-end SMS lifecycle
* [Send SMS](/api-reference/sms/send-sms) — submit messages and obtain `request_id` values