---
title: "Receive delivery reports"
method: POST
path: "receive-whatsapp-delivery-reports"
tags: ["channels", "whatsapp", "whatsapp-message-status-reports", "whatsapp-status-reports"]
---

# Receive delivery reports

`POST receive-whatsapp-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 Customer Support 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

- 0b5f1ca361e90fa0a3f8b907dc53fa34f06ccd85fde4d07f80394e60f5f23c99DeliveryResult
  - `results` 0b5f1ca361e90fa0a3f8b907dc53fa34f06ccd85fde4d07f80394e60f5f23c99DeliveryReport[]: Collection of reports, one per every message.
    - `bulkId` string: The ID that uniquely identifies the request.
    - `price` 3307df001c42dd833d79f33c79b6946b4d01c30ce33030254141df9a2298b3c8Price
      - `currency` string: The currency in which the price is displayed.
      - `pricePerMessage` number, double: The price per individual message.
    - `status` 3307df001c42dd833d79f33c79b6946b4d01c30ce33030254141df9a2298b3c8Status
      - `groupName` string: Group name for the status.
      - `id` integer: Status ID.
      - `groupId` integer: Status group ID.
      - `name` string: Status name.
      - `action` string: Action that should be taken to fix the error.
      - `description` string: Human-readable description of the status.
    - `error` 3307df001c42dd833d79f33c79b6946b4d01c30ce33030254141df9a2298b3c8Error
      - `description` string: Human-readable description of the error.
      - `permanent` boolean: Indicates whether the error is permanent.
      - `name` string: Error name.
      - `id` integer: Error ID.
      - `groupName` string: Error group name.
      - `groupId` integer: Error group ID.
    - `messageId` string: The ID that uniquely identifies the message sent.
    - `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.
    - `sentAt` string, date-time: Tells when the message was sent. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
    - `to` string: The message destination address.
    - `contact` 0b5f1ca361e90fa0a3f8b907dc53fa34f06ccd85fde4d07f80394e60f5f23c99DlrContact
      - `name` string: Display name of the end user.
      - `phoneNumber` string: Sender's phone number. May be absent if the user has enabled the Meta username feature and you have not exchanged messages with them in the last 30 days.
      - `userId` string: Business-scoped user ID (BSUID) assigned by Meta. Stable identifier for the end user, scoped to the receiving business.
      - `parentUserId` string: Business-scoped user ID valid across all phone numbers in a linked business portfolio. Present only for managed businesses with portfolio linking enabled.
      - `username` string: Meta username of the end user. Present only if the user has a Meta 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)