---
title: "Delivery report"
method: POST
path: "DeliveryReport"
tags: ["SMS and MMS"]
---

# Delivery report

`POST DeliveryReport` (webhook)

Sends a notification when an outbound message delivery status changes.

## Payload

- MessagesDeliveryReport — Message delivery report (DLR).
  - `message_id` string, required — Message ID.
  - `message_type` string, required — Type of message. Possible values are `sms`, `mms`.
  - `from` string, required — Sender ID. Can be numeric or alphanumeric.
  - `to` string, required — Destination phone number.
  - `tag` string, nullable — Tag to identify a group of messages, such as those associated with a campaign.
  - `status` 'accepted' | 'pending' | 'sent' | 'delivered' | 'undelivered' | 'expired' | 'rejected' | 'dlr_expired', required — Current delivery status of the message. One of: - `accepted` — the message was accepted by the platform for sending. - `pending` — the message is queued and awaiting a carrier response. - `sent` — the message was handed to the carrier. - `delivered` — the carrier confirmed delivery to the handset. - `undelivered` — the carrier reported that delivery failed. - `expired` — the validity period elapsed before the message was sent. - `rejected` — the message was rejected before sending. - `dlr_expired` — no delivery receipt arrived from the carrier within the expected window.
  - `segments_count` integer, required — Number of message segments for SMS. For MMS, the value is always 1.
  - `sent` string, date-time, nullable, required — Date and time the message was accepted in ISO 8601 format.
  - `delivered` string, date-time, nullable — Date and time when the final status was received in ISO 8601 format.
  - `error` string, nullable — Human-readable error description.
  - `charge` string, required — Total charge for the message in USD.
  - `carrier_fees` string, required — Mobile carrier fees in USD.

## Acknowledgement `200`

Successful callback receipt.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)