---
title: "Get Voice Delivery Reports"
method: GET
path: "/voice/1/reports"
tags: ["channels", "voice", "voice-reports-and-logs"]
---

# Get Voice Delivery Reports

`GET /voice/1/reports`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/voice/1/reports`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

This method allows you to get delivery reports for sent Voice messages, outbound IVR or Click-to-call (without notifyUrl request parameter). Delivery reports are returned only once. Additional delivery report request will return an empty collection.

## Query parameters

- `bulkId` string
- `messageId` string
- `limit` integer

## Response `200`

successful response

- 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aReportResponse
  - `results` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aReport[]: 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` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aVoiceData: Fields representing details specific for voice messages.
      - `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.
      - `direction` 'INBOUND' | 'OUTBOUND': Call direction.
      - `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`).
      - `callRecordingFileId` string: Call recording file identification, if the call was recorded. Currently, populated only if the call was IVR.
      - `ivr` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aIvrData: Fields representing details about IVR, if outbound IVR is being used. If the call was not IVR, the field will be null.
        - `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` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aPrice: Sent voice message price.
      - `pricePerSecond` number: Price per one second of the voice message.
      - `currency` string: The currency in which the price is expressed.
    - `status` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aSingleMessageStatus: 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 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` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aVoiceError: 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.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

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