API Reference

Authorization: Bearer YOUR_API_KEY

{
  "to": "+256741234567",
  "from": "MORTAR",
  "message": "Your OTP is 8823. Do not share this code.",
  "type": "flash"
}

{
  "to": "+256741234567",
  "from": "MORTAR",
  "message": "Your appointment is tomorrow at 9am.",
  "scheduled_at": "2026-05-01T08:00:00+03:00"
}

{
  "event": "message.delivered",
  "message_id": "msg_01J8KP2QRST5UVWX",
  "to": "+256741234567",
  "status": "delivered",
  "network": "airtel",
  "delivered_at": "2026-04-29T09:14:03+03:00",
  "latency_ms": 2840
}

{
  "error": "insufficient_balance",
  "message": "Your wallet balance is too low to send this message.",
  "balance": 0
}

// Node.js — using built-in fetch (v18+)
const MORTAR_API_KEY = process.env.MORTAR_API_KEY;

async function sendSMS({ to, from, message }) {
  const res = await fetch('https://api.mortarbulksms.com/v1/sms', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${MORTAR_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ to, from, message }),
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.message);
  }

  return res.json(); // { id, status, cost, ... }
}

// Usage
sendSMS({
  to: '+256741234567',
  from: 'MORTAR',
  message: 'Your OTP is 4521. Valid 5 mins.',
}).then(console.log);

import os
import requests

API_KEY = os.environ['MORTAR_API_KEY']
BASE_URL = 'https://api.mortarbulksms.com/v1'

def send_sms(to, sender, message, flash=False):
    payload = {
        'to': to,
        'from': sender,
        'message': message,
        'type': 'flash' if flash else 'sms',
    }
    r = requests.post(
        f'{BASE_URL}/sms',
        headers={'Authorization': f'Bearer {API_KEY}'},
        json=payload,
    )
    r.raise_for_status()
    return r.json()

# Example
result = send_sms(
    '+256741234567', 'MORTAR',
    'Hello from Python!'
)
print(f"Sent! ID: {result['id']}, Cost: UGX {result['cost']}")

<?php
function sendSMS($to, $from, $message) {
    $apiKey = getenv('MORTAR_API_KEY');
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL            => 'https://api.mortarbulksms.com/v1/sms',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_HTTPHEADER     => [
            "Authorization: Bearer {$apiKey}",
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS     => json_encode([
            'to'      => $to,
            'from'    => $from,
            'message' => $message,
        ]),
    ]);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($status !== 200) {
        throw new RuntimeException("SMS failed: {$body}");
    }
    return json_decode($body, true);
}

// Usage
$result = sendSMS('+256741234567', 'MORTAR', 'Hello!');
echo "Sent! ID: {$result['id']}\n";

curl -X POST https://api.mortarbulksms.com/v1/sms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+256741234567",
    "from": "MORTAR",
    "message": "Hello from MortarBulkSMS!"
  }'

curl https://api.mortarbulksms.com/v1/sms/msg_01J8KP2QRST5UVWX \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.mortarbulksms.com/v1/sms/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "MORTAR",
    "message": "Hello {name}!",
    "recipients": [
      { "to": "+256741234567", "name": "Alice" },
      { "to": "+256752345678", "name": "Bob" }
    ]
  }'