---
title: "Send SMS message over query parameters"
method: GET
path: "/sms/3/text/query"
tags: ["channels", "sms", "outbound-sms", "send-message"]
---

# Send SMS message over query parameters

`GET /sms/3/text/query`

## 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/3/text/query`
- 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

All message parameters of the message can be defined in the query string. Use this method only if [Send SMS message](#channels/sms/send-sms-messages) is not an option for your use case!<br>**Note:** Make sure that special characters are properly encoded. Use a [URL encoding reference](https://www.w3schools.com/tags/ref_urlencode.asp) as a guide. This endpoint is the successor of [Send SMS message over query parameters](#channels/sms/send-sms-message-over-query-parameters).

## Query parameters

- `bulkId` string
- `from` string
- `to` string[], required
- `text` string, required
- `flash` boolean
- `transliteration` string
- `languageCode` string
- `intermediateReport` boolean
- `notifyUrl` string
- `notifyContentType` string
- `callbackData` string
- `validityPeriod` integer
- `sendAt` string, date-time
- `includeSmsCountInResponse` boolean
- `trackingUrl` string
- `trackingType` string
- `indiaDltContentTemplateId` string
- `indiaDltPrincipalEntityId` string
- `indiaDltTelemarketerId` string
- `turkeyIysBrandCode` integer
- `turkeyIysRecipientType` string
- `southKoreaResellerCode` integer
- `southKoreaTitle` string: Title of the message.

## Response `200`

Successful response

- 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630SmsResponseEnvelope
  - `bulkId` string: Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. If not provided, it will be auto-generated and returned in the API response. Typically used for fetching delivery reports and message logs.
  - `messages` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630MessageResponseSmsMessageResponseDetails[], required: An array of message objects of a single message or multiple messages sent under one bulk ID.
    - `messageId` string: Unique message ID. If not provided, it will be auto-generated and returned in the API response.
    - `status` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630MessageStatus: 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` 'ACCEPTED' | 'PENDING' | 'UNDELIVERABLE' | 'DELIVERED' | 'EXPIRED' | 'REJECTED': Status group name that describes which category the status code belongs to, i.e., [PENDING](https://www.infobip.com/docs/essentials/response-status-and-error-codes#pending-general-status-codes), [UNDELIVERABLE](https://www.infobip.com/docs/essentials/response-status-and-error-codes#undeliverable-general-status-codes), [DELIVERED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#delivered-general-status-codes), [EXPIRED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#expired-general-status-codes), [REJECTED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#rejected-general-status-codes).
      - `id` integer: Status code ID.
      - `name` string: [Status code](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes) name.
      - `description` string: Human-readable description of the status.
      - `action` string: Action to take to recover from the error.
    - `destination` string: The destination address of the message, i.e., its recipient.
    - `details` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630SmsMessageResponseDetails: Other details of the message.
      - `messageCount` integer: Number of SMS message parts required to deliver the message.

## Other responses

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