---
updatedAt: 2026-08-07T08:07:34.000Z
agentTools:
projectIndex: https://docs.verihubs.com/llms.txt
---
# Sandbox - Send SMS V2
SMS OTP version change is by introducing a new API version release.
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.
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
This method helps you to send sms containing desired text to destination number
The following table describes the msisdn option to be used as an input
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" |
# OpenAPI definition
```json
{
"openapi": "3.0.2",
"servers": [
{
"url": "https://api.verihubs.com/"
}
],
"info": {
"title": "Sandbox - SMS API Documentation",
"version": "2.0.0"
},
"tags": [
{
"name": "Sandbox - SMS Notifications and Promotions",
"description": "Get information about SMS Notifications and Promotions API"
}
],
"paths": {
"/v2/sms/send/sandbox": {
"post": {
"tags": [
"Sandbox - SMS Notifications and Promotions"
],
"summary": "Sandbox - Send SMS V2",
"description": "SMS OTP version change is by introducing a new API version release.
\n\nVersion changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.
\n\nThe benefits you get if you use a newer version are as follows.\n- Decreasing processing time in API Request and Response\n- Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers\n- Increase RPS in SMS (before 30rps to 50rps)\n- Better developer environment to support future developments\n- Improve logging and monitoring on our side\n- Improved dependencies and improved service stability
\n\nThis method helps you to send sms containing desired text to destination number
\n\nThe following table describes the msisdn option to be used as an input
\n\n Msisdn | Description | Response |\n---------------- |:---------------------|:-------------------------- |\n6282123060001 | Valid Phone number | 201 \"SMS sent successfully\" |\n6282123060002 | Msisdn invalid | 400 \"Msisdn invalid: msisdn length should between 4-16 characters\" |\n6282123060003 | Invalid Header | 401 \"Authorization failed\" |\n6282123060004 | insufficient quota | 403 \"testing quota is insufficent\" |\n6282123060005 | Blocked Msisdn | 409 \"Msisdn invalid: msisdn has been blocked\" |\n6282123060006 | Too Many Request | 429 \"Too many request in the allowed time frame\" |\n",
"operationId": "sandbox_send_sms_post_v2",
"parameters": [
{
"required": true,
"schema": {
"title": "App-ID",
"type": "string"
},
"name": "app-id",
"in": "header"
},
{
"required": true,
"schema": {
"title": "API-Key",
"type": "string"
},
"name": "api-key",
"in": "header"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SendSms"
}
}
},
"required": true
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResponseSendSms"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResponseSend400"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResponseSend401"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResponseSend429"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResponseSend500"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"SendSms": {
"title": "SendSms",
"required": [
"msisdn",
"text"
],
"type": "object",
"properties": {
"msisdn": {
"description": "Destination Phone Number. You need to include international prefix number.",
"type": "string",
"example": "6282123060001"
},
"text": {
"description": "SMS Body",
"type": "string",
"example": "This is text example"
},
"premium": {
"description": "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",
"type": "boolean",
"example": true
},
"callback_url": {
"description": "Optional. This URL will be called by the server when the desired event will occur. Callback will work if you use premium route",
"type": "string",
"example": "https://your-url-callback.com"
}
}
},
"ResponseSendSms": {
"title": "ResponseSendSms",
"required": [
"message",
"msisdn",
"session_id"
],
"type": "object",
"properties": {
"message": {
"description": "Message",
"type": "string",
"example": "SMS sent successfully"
},
"msisdn": {
"description": "destination number with international prefix country code.",
"example": 6282123060001
},
"session_id": {
"description": "Generated ID which associated with verification request.",
"example": "asddede-asdae234-34sfd3-fe234d"
},
"segment_count": {
"description": "Shows segmentation SMS where SMS with over 160 characters will be split into more than 1 segment.",
"type": "integer",
"example": 2
}
}
},
"ResponseSend400": {
"title": "Error Validation",
"required": [
"message"
],
"type": "object",
"properties": {
"message": {
"description": "Message",
"type": "string",
"example": "Msisdn is not allowed, please use the custom msisdn"
}
}
},
"ResponseSend401": {
"title": "Error Validation",
"required": [
"message"
],
"type": "object",
"properties": {
"message": {
"description": "Message",
"type": "string",
"example": "Authorization failed"
}
}
},
"ResponseSend429": {
"title": "Error Validation",
"required": [
"message"
],
"type": "object",
"properties": {
"message": {
"description": "Message",
"type": "string",
"example": "Too many request in the allowed time frame"
}
}
},
"ResponseSend500": {
"title": "Error Validation",
"required": [
"message"
],
"type": "object",
"properties": {
"message": {
"description": "Message",
"type": "string",
"example": "Internal Server Error"
}
}
}
}
}
}
```