---
title: "Send SMS"
method: POST
path: "/send-sms.json"
tags: ["SMS"]
---

# Send SMS

`POST /send-sms.json`

You can elect to pass us the recipient numbers from your database each time you make a call, or you can elect to store recipient data in a contact list and submit only the list_id to trigger the send. This is best for large databases. To add a list please refer to the add-list call.

## Response `200`

OK

- object
  - `message_id` integer — Numeric ID assigned to the message sent. This can be used in conjunction with other calls to retrieve information and reporting about the message sent.
  - `send_at` string, date-time — Date and time that message was sent from your account Returned in ISO8601 format YYYY-MM-DD HH:MM:SS in UTC Timezone.
  - `recipients` integer — Recipient count. Count of number of recipients message was sent to either in list or to parameter.
  - `cost` number — Total cost of all messages. Returned as value per account currency to 3 decimal places 0.000
  - `sms` integer — Total number of message parts delivered. If the message is longer than 160 characters this will return count of all parts. Eg. if a 180 character message is delivered to 2 recipients. Value returned will be 4.
  - `list` object — Information about the list the message was sent Timezone.
    - `id` integer — This ID is the numerical reference to one of your recipient lists. It is found in the URL and displayed on a destination list page in your account.
    - `name` string — Name of the list that message was sent to.
  - `delivery_stats` object — Delivery stats.
    - `delivered` integer — Number of delivered messages.
    - `pending` integer — Number of pending messages.
    - `bounced` integer — Number of bounced messages.
    - `responses` integer — Number of responses.
    - `optouts` integer — Number of opt-outs.
  - `error` object — Error messages related to this call: | CODE | HEADER | DESCRIPTION | |---------------|------------------|-----------------------------------------------------------------------| | LEDGER_ERROR | 400 | There was a problem with payment. Please check the output for more details. | | LIST_EMPTY | 400 | The list you provided doesn't have active recipients. | | RECIPIENTS_ERROR | 400 | No valid recipients left after validation. |
    - `code` string — Error code.
    - `header` integer — Error code.
    - `description` string — Description of the error.

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/versions/9f6c34b849af/schema)