---
title: "Receive delivery status report"
method: POST
path: "receive-omni-failover-message-delivery-reports"
tags: ["channels", "omni-failover", "send-omni-message"]
---

# Receive delivery status report

`POST receive-omni-failover-message-delivery-reports` (webhook)

For each message that you send out, we can send you a delivery report. For this to work you need to have an endpoint to forward the reports to. Please provide the endpoint’s URL to your Account Manager and they will set it up for you. Once the setup is complete, we will be able to deliver the [reports](https://www.infobip.com/docs/essentials/response-status-and-error-codes) to you in real time. Alternatively you can specify the endpoint per each message via the `notifyUrl` parameter. Contact support@infobip.com if you require help. Use one URL for all report types.

## Payload

- 8a2ea8872469b182f7474a94d4bf931da42a6e2a1d1ba07898b1bc7dcdc85cd2DeliveryReports
  - `results` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11DeliveryReport[]: Collection of reports.
    - `bulkId` string: The ID that uniquely identifies the request.
    - `messageId` string: The ID that uniquely identifies the message sent.
    - `to` string: The message destination address.
    - `sentAt` string, date-time: Tells when the message was sent. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
    - `doneAt` string, date-time: Tells when the message was finished processing by Infobip (ie. delivered to destination, delivered to destination network, etc.).
    - `messageCount` integer: The number of sent message segments.
    - `mccMnc` string: Mobile country and network codes.
    - `price` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11Price: Sent message price.
      - `pricePerMessage` number: Price per message.
      - `currency` string: Currency.
    - `status` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11Status: Indicates whether the message is successfully sent, not sent, delivered, not delivered, waiting for delivery or any other possible status.
      - `groupId` integer: Status group ID.
      - `groupName` string: Status group name.
      - `id` integer: Status ID.
      - `name` string: Status name.
      - `description` string: Human-readable description of the status.
      - `action` string: Action that should be taken to eliminate the error.
    - `error` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11Error: Indicates whether the error occurred during the query execution.
      - `groupId` integer: Error group ID.
      - `groupName` string: Error group name.
      - `id` integer: Error ID.
      - `name` string: Error name.
      - `description` string: Human-readable description of the error.
      - `permanent` boolean: Tells if the error is permanent.
    - `channel` 'SMS' | 'EMAIL' | 'VOICE' | 'PUSH' | 'VIBER' | 'LINE' | 'VKONTAKTE' | 'KAKAO_CHINGU' | 'KAKAO_ALIM' | 'WHATSAPP': Channel that was used for message delivering.
    - `callbackData` string
    - `contact` 8a2ea8872469b182f7474a94d4bf931da42a6e2a1d1ba07898b1bc7dcdc85cd2Contact: Contact information. Exists in case of WhatsApp Message.
      - `name` string: Contact name.
      - `phoneNumber` string: Sender's phone number.
      - `userId` string: User ID.
      - `parentUserId` string: Parent user ID.
      - `username` string: Username.

## Acknowledgement `200`

Your server returns this code if it accepts the callback.

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)