---
title: "Get OMNI failover delivery reports"
method: GET
path: "/omni/1/reports"
tags: ["channels", "omni-failover", "send-omni-message"]
---

# Get OMNI failover delivery reports

`GET /omni/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/omni/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

Get one-time delivery reports to see which channel was used to deliver the failover message.

## Query parameters

- `bulkId` string
- `messageId` string
- `limit` integer
- `channel` 'SMS' | 'EMAIL' | 'VOICE' | 'PUSH' | 'VIBER' | 'LINE' | 'VKONTAKTE' | 'KAKAO_CHINGU' | 'KAKAO_ALIM' | 'WHATSAPP': Channel that was used for message delivering.

## Response `200`

successful response

- 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.

## Other responses

- `400`: bad request responses
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

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