---
title: "Receive Voice Delivery Reports"
method: POST
path: "receive-voice-delivery-reports"
tags: ["channels", "voice", "voice-reports-and-logs"]
---

# Receive Voice Delivery Reports

`POST receive-voice-delivery-reports` (webhook)

We can send you delivery reports for Voice messages, outbound IVR, Click-to-call or Markup Language in real time. All you need to do is specify notifyUrl in your endpoint when using some of these features and we will deliver a [status](https://www.infobip.com/docs/essentials/response-status-and-error-codes) report to your platform.

## Payload

- B5f674fb4d8d190ed269baf3b9aaf29827a4d03ec2de31bb6b608809be9a182bVoiceReportsResponse
  - `results` B5f674fb4d8d190ed269baf3b9aaf29827a4d03ec2de31bb6b608809be9a182bVoiceReport[]: Arrays of delivery reports, one object for every message.
    - `bulkId` string: The ID that uniquely identifies the bulk of messages.
    - `messageId` string: The ID that uniquely identifies the message sent.
    - `from` string: The sender ID which can be alphanumeric or numeric.
    - `to` string: Destination address of the voice message.
    - `sentAt` string: Date and time when the voice message was initiated. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
    - `mccMnc` string: Mobile country and network codes.
    - `callbackData` string: Custom data sent over to the notifyUrl.
    - `voiceCall` B5f674fb4d8d190ed269baf3b9aaf29827a4d03ec2de31bb6b608809be9a182bVoiceData
      - `feature` string: Name of the Infobip Voice service or feature.
      - `startTime` string: Date and time when the voice message was established and started ringing. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
      - `answerTime` string: Date and time when the voice message was answered. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
      - `endTime` string: Date and time when the voice message was ended. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
      - `duration` integer: Duration of the voice message, in seconds.
      - `chargedDuration` integer: Charged duration of the voice message, in seconds.
      - `fileDuration` number, double: Duration of the voice message audio file, in seconds.
      - `dtmfCodes` string: DTMF code entered by user. Can be empty string, if user did not press anything, or `null` in case of IVR if user did not participate in Collect action.
      - `answeredBy` string: If machine detection is used, contains the result of the machine detection (`HUMAN` or `MACHINE`). Currently, populated only if the call was IVR.
      - `callRecordingFileId` string: Call recording file identification, if the call was recorded. Currently, populated only if the call was IVR. The file can be downloaded using [calls api](https://www.infobip.com/docs/api/channels/voice/calls/files-and-recordings/download-recording-file).
      - `direction` string: Call direction.
      - `ivr` B5f674fb4d8d190ed269baf3b9aaf29827a4d03ec2de31bb6b608809be9a182bIvrData
        - `scenarioId` string: The ID that uniquely identifies the IVR scenario.
        - `scenarioName` string: Name of IVR scenario.
        - `collectedDtmfs` string: JSON object showing the result of every CollectAction in IVR scenario in the form of key/value pairs, where the key is CollectAction variable and pair is collected DTMF.
        - `collectedMappedDtmfs` string: JSON object showing the result of every CollectAction in IVR scenario with the mapped, meaningful, values you defined in CollectAction `mappedValues` option.
        - `spokenInput` string: JSON object showing the result of every CaptureSpeech action with full text spoken by the user.
        - `matchedSpokenInput` string: JSON object showing the result of every CaptureSpeech action with only the key phrases that matched user spoken input.
    - `price` A22294a21e0a6f95f3711ca1f29de62bd2ce6d8bf890b9e41dadab263638faafPrice
      - `pricePerSecond` number, double: Price per one second of the Voice message.
      - `currency` string: The currency in which the price is expressed.
    - `status` A22294a21e0a6f95f3711ca1f29de62bd2ce6d8bf890b9e41dadab263638faafStatus
      - `groupId` integer: Status group ID.
      - `groupName` string: Status group name that describes which category the status code belongs to, e.g. PENDING, UNDELIVERABLE, DELIVERED, EXPIRED, REJECTED.
      - `id` integer: Status ID.
      - `name` string: Status name.
      - `description` string: Human-readable description of the status.
    - `error` A22294a21e0a6f95f3711ca1f29de62bd2ce6d8bf890b9e41dadab263638faafError
      - `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.

## 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)