---
title: "Send single SMS (JSON)"
method: POST
path: "/v2/JsonSingleApi"
tags: ["JSON Message"]
---

# Send single SMS (JSON)

`POST /v2/JsonSingleApi`

Send a single SMS to one or more recipients via JSON request body.

**Key Features:**
- JSON request/response format
- Optional AES-256 GCM encryption for in-transit security (set `X-SSL: 2` header)
- Supports synchronous or asynchronous processing
- DLT/TRAI compliant messaging

**Encryption Mode (X-SSL=2):**
When encryption is enabled, the entire request body is AES-256 GCM encrypted.
IV and AES key can be provided in headers (`X-SSLIV`, `X-AES-KEY`) or fetched from DB using `feedid`.
The `feedid` query parameter is required when using encryption.

**JSON via query parameter:**
Alternatively, the JSON payload can be passed as the `json` query parameter instead of in the request body.

## Query parameters

- `feedid` string
- `json` string

## Headers

- `X-SSL` '1' | '2'
- `X-SSLIV` string
- `X-AES-KEY` string

## Request body

- JsonSingleApiV2Request
  - `feedid` string — Account/Feed ID used for authentication and required for encryption key retrieval.
  - `username` string — Username or registered mobile number for authentication.
  - `password` string, password — Password associated with the username.
  - `jobname` string — Custom name assigned to the message batch for tracking.
  - `short` string — URL shortener flag: 0 = off (default), 1 = on
  - `tz` string — Timezone for scheduled time (e.g. GMT+05:30)
  - `time` string — Future publish time (yyyymmddhhmm or yyyy-MM-dd HH:mm)
  - `mobile` string, required — Comma-separated mobile numbers
  - `messages` string, required — SMS message content (alias: message)
  - `message` string — SMS message content to be sent.
  - `senderid` string — Sender ID
  - `entityid` string — DLT entity ID
  - `templateid` string — DLT template ID
  - `async` '0' | '1' — 0 = sync (default), 1 = async
  - `dlt_template_type` string — DLT template type
  - `jobid` string — Job ID
  - `mtype` string — Message type (1 = text)
  - `url` string — WAP URL for WAP push
  - `udh` string — UDH for binary messages
  - `hexflag` string — Hex flag for encoded messages
  - `response_type` 'json' | 'xml' — Response format
  - `DepId` string — Department ID
  - `AppID` string — Application ID
  - `ssl` string — Encryption mode (when in JSON body)
  - `ssliv` string — IV (when message encrypted in JSON)
  - `aesKey` string — AES key (when message encrypted in JSON)

## Response `200`

The request was processed successfully.

## Other responses

- `400` — The request is invalid due to malformed input or missing data.
- `500` — The request failed due to an unexpected server-side issue.

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)