---
title: "Get outbound SMS message delivery reports"
method: GET
path: "/sms/1/reports"
tags: ["channels", "sms", "logs-and-status-reports"]
---

# Get outbound SMS message delivery reports

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

If you are for any reason unable to receive real-time delivery reports on your endpoint, you can use this API method to learn if and when the message has been delivered to the recipient. Each request will return a batch of delivery reports - only once. The following API request will return only new reports that arrived since the last API request in the last 48 hours.

## Query parameters

- `bulkId` string
- `messageId` string
- `limit` integer
- `applicationId` string
- `entityId` string
- `campaignReferenceId` string

## Response `200`

successful response

- 1705572441d20bbbfe49765ca2bed87cd314f9c5c501048d5a9494385ff9f223SMSReportResponse
  - `results` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630SmsReport[]
    - `bulkId` string: Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request.
    - `messageId` string: Unique message ID.
    - `to` string: Message destination address.
    - `from` string: The sender ID which can be alphanumeric or numeric (e.g., `CompanyName`).
    - `sentAt` string, date-time: Date and time when the message was [scheduled](#channels/sms/get-scheduled-sms-messages) to be sent. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
    - `doneAt` string, date-time: Date and time when the Infobip services finished processing the 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`.
    - `smsCount` integer: The number of parts the message content was split into.
    - `mccMnc` string: Mobile country and network codes.
    - `callbackData` string: Callback data sent through ‛callbackData‛ field when sending message.
    - `price` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Price: Sent SMS price.
      - `pricePerMessage` number, double: Price per one SMS.
      - `currency` string: The currency in which the price is expressed.
    - `status` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Status: Indicates the [status](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes) of the message and how to recover from an error should there be any.
      - `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](https://www.infobip.com/docs/essentials/response-status-and-error-codes).
      - `description` string: Human-readable description of the status.
      - `action` string: Action that should be taken to recover from the error.
    - `error` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Error: Indicates whether an 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.
    - `entityId` string: The entity used when sending the message. For more details, see our [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `applicationId` string: The application used when sending the message. For more details, see our [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `campaignReferenceId` string: ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel.

## Other responses

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

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification-2.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification-2/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification-2/revisions/4a6f8044a927?raw)