# Kusha SMS

> Kusha SMS (https://kushasms.com) is a bulk SMS platform for Nepal, operated by Sahasra Tech.
> It sends campaigns, alerts, OTPs and dynamic per-recipient messages to NTC (Nepal Telecom)
> and Ncell numbers, with contact management, message templates, scheduled sending, live
> delivery reports and a token-authenticated REST API. Billing is prepaid credits with no
> setup fee.

## Features

- Bulk & campaign SMS: send to lists or groups with merge fields and an instant cost preview.
- Dynamic SMS: upload a file to give every number its own unique message (receipts, codes, reminders).
- Contacts & groups: import contacts, organise into groups, maintain a blocklist.
- Scheduling & templates: queue sends for later and reuse approved templates.
- Delivery reports: live per-message delivery status and 30-day analytics.
- Developer API: REST API with token auth and webhooks for delivery callbacks.

## Free tools

- [SMS character counter](https://kushasms.com/sms-character-counter): count characters, encoding
  (GSM-7 vs Unicode), SMS parts and credits for a message, plus a full reference on how Nepali
  (Devanagari) text is counted. Nepali sends as Unicode: 70 characters per SMS, 67 per part in a
  multipart message; plain English sends as GSM-7 at 160 and 153. One character outside the GSM-7
  alphabet — a Devanagari letter or digit, the danda, an emoji, a curly quote — moves the whole
  message to the 70-character limit. Billing is one credit per part per recipient.

## API quickstart

Send an SMS with one request. Get a token by registering at
https://kushasms.com/register, then creating one under Developers -> API Tokens:

    curl -X POST https://kushasms.com/sms/v4/send-user \
      -H "auth-token: <your-token>" \
      -H "Content-Type: application/json" \
      -d '{"to":["98XXXXXXXX"],"text":["Hello from Kusha SMS"]}'

Note for automated clients: every endpoint answers HTTP 200 — read the `error` field
in the body, not the status code. There is no sandbox, so a message that is accepted
is delivered and charged. Read the testing checklist in the full manual first.

## API documentation

- [API manual](https://kushasms.com/api-docs): the complete human reference
- [llms-full.txt](https://kushasms.com/llms-full.txt): the same manual as plain Markdown, in one request
- [openapi.json](https://kushasms.com/openapi.json): OpenAPI 3.1 spec — load it as a tool definition

## Pages

- [Home](https://kushasms.com/): product overview, features and how it works
- [SMS character counter](https://kushasms.com/sms-character-counter): free tool + reference for
  counting Nepali and English SMS characters, parts and credits
- [Register](https://kushasms.com/register): create an account and get API access
- [Sign in](https://kushasms.com/login): existing customers