---
title: "Preview SMS message"
method: POST
path: "/sms/1/preview"
tags: ["channels", "sms", "outbound-sms", "send-message"]
---

# Preview SMS message

`POST /sms/1/preview`

## 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/preview`
- 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

Avoid unpleasant surprises and check how different message configurations will affect your message text, number of characters and message parts.

## Request body

- 01e84c3b4dd6fb6c49761ac60f0bbc50e5117905a6beb7547645113e59aaeb46PreviewRequest
  - `text` string, required: Content of the message being sent.
  - `languageCode` string: [Language code](https://www.infobip.com/docs/sms/language#national-language-identifier) for the correct character set. `AUTODETECT` lets the platform select the character set based on message content only for supported languages.
  - `transliteration` string: The transliteration of your sent message from one script to another. [Transliteration](https://www.infobip.com/docs/sms/language#sms-transliteration) is used to replace characters which are not recognized as part of your defaulted alphabet. `ALL` means that the transliteration process will recognize all supported languages.

## Response `200`

successful response

- B888d833f5e2077036527211f9d9a5502285e1c742cd8459a9d3ad85cb1fa1f5PreviewResponse
  - `originalText` string: Message content supplied in the request.
  - `previews` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Preview[]: Allows for previewing the original message content once additional language configuration has been applied to it.
    - `textPreview` string: Preview of the message content as it should appear on the recipient’s device.
    - `messageCount` integer: Number of SMS message parts required to deliver the message.
    - `charactersRemaining` integer: Number of remaining characters in the last part of the SMS.
    - `configuration` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630LanguageConfiguration: Sets up additional configuration that changes the original message content you can preview with this call.
      - `language` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Language
        - `languageCode` string: [Language code](https://www.infobip.com/docs/sms/language#national-language-identifier) for the correct character set. `AUTODETECT` lets the platform select the character set based on message content only for supported languages.
      - `transliteration` string: Conversion of a message text from one script to another. Possible values: `TURKISH`, `GREEK`, `CYRILLIC`, `SERBIAN_CYRILLIC`, `BULGARIAN_CYRILLIC`, `CENTRAL_EUROPEAN`, `BALTIC`, `NON_UNICODE` and `ALL`.

## Other responses

- `400`: Error 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)