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

# Get Voice Delivery Reports

`GET /tts/3/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/tts/3/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

> **Deprecated.**

This version is deprecated as of July 1st 2020, meaning no fixes/updates will be provided and no new parameters will be added.


"We strongly advise you to update to new [delivery report method](https://www.infobip.com/docs/api/channels/voice/voice-reports-and-logs/get-voice-delivery-reports).

## Query parameters

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

## Response `200`

successful response

- 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aVoiceReportResponse
  - `results` 13d6cf838c63455fe28fcf6ab1b4447c03d816f87ce89525d3cd759ca08a7b1aVoiceReport[]: 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.
    - `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.
    - `doneAt` string: Date and time when the Infobip services finished processing the voice message (i.e. delivered to the destination, delivered to the destination network, etc.). Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
    - `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.
    - `endTime` string: Date and time when the voice message was ended. 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.
    - `duration` integer: Duration of the voice message, in seconds.
    - `fileDuration` number, double: Duration of the voice message audio file, in seconds.
    - `mccMnc` string: Mobile country and network codes.
    - `callbackData` string: Custom data sent over to the notifyUrl.
    - `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.
    - `recordedAudioFileUrl` string: Url to retrieve recorded calls that were made by voice messages with the record feature activated. Using that URL with GET method will initiate the download of the recorded file. If using a REST testing client, make sure to save the downloaded data instead of displaying it in the client’s response area. Recordings are encoded as PCM WAVE signed little-endian 16bit 8kHz audio files.
    - `scenarioId` string: The ID that uniquely identifies the IVR scenario.
    - `scenarioName` string: Name of IVR scenario.
    - `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)