---
title: "Sandbox - Send SMS V2"
method: POST
path: "/v2/sms/send/sandbox"
tags: ["Sandbox - SMS Notifications and Promotions"]
---

# Sandbox - Send SMS V2

`POST /v2/sms/send/sandbox`

SMS OTP version change is by introducing a new API version release.<br>

Version changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.<br>

The benefits you get if you use a newer version are as follows.
- Decreasing processing time in API Request and Response
- Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers
- Increase RPS in SMS (before 30rps to 50rps)
- Better developer environment to support future developments
- Improve logging and monitoring on our side
- Improved dependencies and improved service stability<br>

This method helps you to send sms containing desired text to destination number<br>

The following table describes the msisdn option to be used as an input<br>

 Msisdn          | Description          | Response |
---------------- |:---------------------|:-------------------------- |
6282123060001       | Valid Phone number          | 201 "SMS sent successfully" |
6282123060002        |   Msisdn invalid           | 400 "Msisdn invalid: msisdn length should between 4-16 characters" |
6282123060003        | Invalid Header           |  401 "Authorization failed" |
6282123060004        | insufficient quota            |  403 "testing quota is insufficent" |
6282123060005        | Blocked Msisdn            |  409 "Msisdn invalid: msisdn has been blocked" |
6282123060006        | Too Many Request            |  429 "Too many request in the allowed time frame" |

## Headers

- `app-id` string, required
- `api-key` string, required

## Request body

- SendSms
  - `msisdn` string, required — Destination Phone Number. You need to include international prefix number.
  - `text` string, required — SMS Body
  - `premium` boolean — used for Transactional SMS (Text Message from Business to Customer that provides valuable information about their product, service or processes) or OTP with better Network Connections
  - `callback_url` string — Optional. This URL will be called by the server when the desired event will occur. Callback will work if you use premium route

## Response `201`

Successful Response

- ResponseSendSms
  - `message` string, required — Message
  - `msisdn` unknown, required
  - `session_id` string, required — Generated ID which associated with verification request.
  - `segment_count` integer — Shows segmentation SMS where SMS with over 160 characters will be split into more than 1 segment.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/sms-api-documentation.md) · [All operations](https://skmtc.dev/verihubs/apis/sms-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verihubs/sms-api-documentation/revisions/5fa885d38adc/schema)