Nepal's Fastest SMS API. Integrate in Minutes.

# Quick start
curl -X POST https://app.bharosasms.com/api/v1/sms/send/ \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["98XXXXXXXX"],
    "text": "Hello from Bharosa SMS!",
    "sender_id": { "NT": "YourSenderID", "Ncell": "YourSenderID" },
    "message_type": "plain"
  }'

# ── Plain send ────────────────────────────────────────
curl -X POST https://app.bharosasms.com/api/v1/sms/send/ \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["98XXXXXXXX", "97XXXXXXXX"],
    "text": "Hello from Bharosa SMS!",
    "sender_id": { "NT": "YourSenderID", "Ncell": "YourSenderID" },
    "message_type": "plain"
  }'

# ── Scheduled send ────────────────────────────────────
curl -X POST https://app.bharosasms.com/api/v1/sms/send/ \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["98XXXXXXXX"],
    "text": "Your appointment is tomorrow at 10am.",
    "sender_id": { "NT": "CLINIC", "Ncell": "CLINIC" },
    "message_type": "plain",
    "scheduled_at": "2026-04-20 09:00:00"
  }'

# ── Nepali unicode ────────────────────────────────────
curl -X POST https://app.bharosasms.com/api/v1/sms/send/ \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["98XXXXXXXX"],
    "text": "नमस्ते! हाम्रो सेवामा स्वागत छ।",
    "sender_id": { "NT": "MYAPP", "Ncell": "MYAPP" },
    "message_type": "unicode"
  }'

// Node 18+ has built-in fetch. For older versions: npm install node-fetch
const API_KEY  = process.env.BHAROSA_API_KEY;
const ENDPOINT = 'https://app.bharosasms.com/api/v1/sms/send/';

async function sendSMS({ to, text, senderNT, senderNcell, messageType = 'plain', scheduledAt = null }) {
  const body = {
    to: Array.isArray(to) ? to : [to],
    text,
    sender_id:    { NT: senderNT, Ncell: senderNcell },
    message_type: messageType,
    ...(scheduledAt && { scheduled_at: scheduledAt }),
  };

  const res = await fetch(ENDPOINT, {
    method:  'POST',
    headers: { 'X-API-KEY': API_KEY, 'Content-Type': 'application/json' },
    body:    JSON.stringify(body),
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.error || err.detail);
  }
  return res.json();
  // → { message, batch_id, cost, pages, failed_numbers }
}

// ── Plain send ────────────────────────────────────────
const result = await sendSMS({
  to: ['98XXXXXXXX', '97XXXXXXXX'],
  text: 'Hello from Node.js!',
  senderNT: 'MYAPP', senderNcell: 'MYAPP',
});
console.log(`Batch: ${result.batch_id} | Cost: ${result.cost}`);

// ── Scheduled send ────────────────────────────────────
await sendSMS({
  to: '98XXXXXXXX',
  text: 'Reminder: appointment tomorrow at 10am.',
  senderNT: 'CLINIC', senderNcell: 'CLINIC',
  scheduledAt: '2026-04-20 09:00:00',
});

// ── Nepali unicode ────────────────────────────────────
await sendSMS({
  to: '98XXXXXXXX',
  text: 'नमस्ते! हाम्रो सेवामा स्वागत छ।',
  senderNT: 'MYAPP', senderNcell: 'MYAPP',
  messageType: 'unicode',
});

import os
import requests

API_KEY  = os.environ["BHAROSA_API_KEY"]
ENDPOINT = "https://app.bharosasms.com/api/v1/sms/send/"
HEADERS  = {"X-API-KEY": API_KEY, "Content-Type": "application/json"}


def send_sms(to, text, sender_nt, sender_ncell,
           message_type="plain", scheduled_at=None):
    """
    to           : str | list[str]
    text         : str
    sender_nt    : str   NTC sender ID
    sender_ncell : str   Ncell sender ID
    message_type : "plain" | "unicode"  (unicode for Nepali text)
    scheduled_at : str | None  "YYYY-MM-DD HH:MM:SS"
    """
    payload = {
        "to":           [to] if isinstance(to, str) else to,
        "text":         text,
        "sender_id":    {"NT": sender_nt, "Ncell": sender_ncell},
        "message_type": message_type,
    }
    if scheduled_at:
        payload["scheduled_at"] = scheduled_at

    r = requests.post(ENDPOINT, json=payload, headers=HEADERS)
    r.raise_for_status()  # raises HTTPError on 4xx / 5xx
    return r.json()


# ── Plain send ────────────────────────────────────────
result = send_sms(
    to=["98XXXXXXXX", "97XXXXXXXX"],
    text="Hello from Python!",
    sender_nt="MYAPP", sender_ncell="MYAPP",
)
print(f"Batch {result['batch_id']} | Cost: {result['cost']}")

# ── Scheduled send ────────────────────────────────────
send_sms(
    to="98XXXXXXXX",
    text="Reminder: your appointment is tomorrow.",
    sender_nt="CLINIC", sender_ncell="CLINIC",
    scheduled_at="2026-04-20 09:00:00",
)

# ── Nepali unicode ────────────────────────────────────
send_sms(
    to="98XXXXXXXX",
    text="नमस्ते! हाम्रो सेवामा स्वागत छ।",
    sender_nt="MYAPP", sender_ncell="MYAPP",
    message_type="unicode",
)

<?php
// Store your key in .env — never hardcode it
$apiKey   = $_ENV['BHAROSA_API_KEY'];
$endpoint = 'https://app.bharosasms.com/api/v1/sms/send/';

function sendSMS(
  array   $to,
  string  $text,
  string  $senderNT,
  string  $senderNcell,
  string  $messageType = 'plain',
  ?string $scheduledAt = null
): array {
  global $apiKey, $endpoint;

  $payload = [
    'to'           => $to,
    'text'         => $text,
    'sender_id'    => ['NT' => $senderNT, 'Ncell' => $senderNcell],
    'message_type' => $messageType,
  ];
  if ($scheduledAt) $payload['scheduled_at'] = $scheduledAt;

  $ch = curl_init($endpoint);
  curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
      'X-API-KEY: ' . $apiKey,
      'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
  ]);

  $body   = curl_exec($ch);
  $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
  curl_close($ch);

  $data = json_decode($body, true);
  if ($status >= 400) throw new Exception($data['error'] ?? $data['detail']);
  return $data;
}

// ── Plain send ────────────────────────────────────────
$r = sendSMS(['98XXXXXXXX', '97XXXXXXXX'], 'Hello from PHP!', 'MYAPP', 'MYAPP');
echo "Batch: {$r['batch_id']} | Cost: {$r['cost']}";

// ── Scheduled send ────────────────────────────────────
sendSMS(['98XXXXXXXX'], 'Appointment tomorrow 10am.',
        'CLINIC', 'CLINIC', 'plain', '2026-04-20 09:00:00');

// ── Nepali unicode ────────────────────────────────────
sendSMS(['98XXXXXXXX'], 'नमस्ते! हाम्रो सेवामा स्वागत छ।',
        'MYAPP', 'MYAPP', 'unicode');
?>