---
title: "Get sms status reports."
method: GET
path: "/v4/sms/outgoing/reports"
tags: ["Sms - Outgoing"]
---

# Get sms status reports.

`GET /v4/sms/outgoing/reports`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/sms/outgoing/reports`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

Each report will only be returned once. Once called, the status has been removed from our side and cannot be retrieved again using this method.
Using api callbacks in combination with this call does not conflict.

## Query parameters

- `limit` integer

## Response `200`

A list of status reports

- StatusReportListModel
  - `reports` StatusReport[]: A list of reports.
    - `messageId` string: The id of the message.
    - `numberDetails` StatusReportNumberDetails: The parsed extended details about the msisdn provided.
      - `countryCode` string: The country code part of the msisdn, e.g. 45.
      - `phoneNumber` string: The phone number part of the msisdn, e.g. 12345678.
      - `rawMsisdn` string: The input msisdn in its unaltered format. This is the value provided when sending the text message.
      - `msisdn` string: The final cleaned msisdn.
      - `isValidMsisdn` boolean: True if the input msisdn was valid.
      - `countryHint` string: The country code hint if provided in the request.
      - `isAnonymized` boolean: Specifies whether the message has been anonymized or not.
    - `deliveryInfo` DeliveryInfo
      - `stateCode` 0 | 1 | -2 | -1: 0 = Unknown 1 = Delivered -2 = Cancelled -1 = Failed
      - `stateDescription` string: A text description of the state code
      - `sendTime` string: When the message was sent e.g. 2001-02-30T14:50:23Z (UTC time)
      - `doneTime` string: When the delivery of the message fails, is cancelled, or is delivered. If the operator does not support reporting the actual delivery time, this will be the time when the delivery report is received from the operator. In some cases where the message is not sent, this value can be null.
      - `errorCode` integer: A code describing the error if the state is not Delivered. This property will be absent in case the state is Delivered. -1 = Undeliverable message -2 = Msisdn blacklisted by operator -3 = Invalid mobile number -4 = Country not available -5 = Delivery timeout -6 = Not delivered removed from gateway -8 = Insufficient funds -9 = Authorize failed -10 = Capture failed -11 = Overcharge donation limit exceeded -12 = Overcharge type not activated -13 = Overcharge settings not valid -14 = Sender name blocked -15 = Route not available -16 = Refund not available -17 = Refund not possible for message -18 = Refund failed -19 = Refund not possible for pending message -20 = Refund not possible for failed message -21 = Refund failed already refunded -22 = Delivery timeout before sent -23 = Message queue full at operator -80 = Imported from other system -99 = Submit failed -100 = Communication error -101 = Unknown id -102 = Cancelled -103 = Unknown error processing message -104 = Unknown id at operator -105 = Msisdn blacklisted on account -106 = Mobile number cooldown -107 = Quota limit exceeded -201 = Suspicious sms content -202 = Account deactivated -300 = Pdu sequence incomplete -301 = Pdu sequence invalid
      - `errorDescription` string: A text description of the error code
    - `chargeInfo` ChargeInfo
      - `isCharged` boolean: True if the message will be charged.
      - `smsCount` integer: The total sms count in the message. If IsCharged is true, this is the number of sms'es that will be charged.
      - `encoding` string: The encoding of the message. Can be either "gsm7" or "ucs2". In case the message was submitted with encoding "auto", this report will reveal the final encoding based on the characters in the message text. "gsm7" is the default alfabet for text messages and when using gsm7, a single sms message can contain 160 characters. If the length exceeeds 160 characters, the message is actually split up into parts of 153 characters and charged according to this. Please note, that a few, specific characters fill up 2 bytes and count for 2 letters. Ref: https://en.wikipedia.org/wiki/GSM_03.38 "ucs2"" allows for more non-roman characters to be used along with smileys. When using this encoding, a single message can consist of 70 characters. If the message exceeds 70 characters, the final message is actually split into parts of 67 characters.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/inmobile/apis/inmobile-rest-api.md) · [All operations](https://skmtc.dev/inmobile/apis/inmobile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inmobile/apis/inmobile-rest-api/revisions/197a90ad5f8f?raw)