API Documentation

import requests

BASE = "https://app.bulksmsrates.com/v1"
HEADERS = {
    "X-API-Key": "bsms_live_...",
    "X-API-Secret": "sk_live_...",
}

# Send SMS
def send_sms(to, body, sender="MyApp"):
    return requests.post(f"{BASE}/sms/send", headers=HEADERS,
        json={"to": to, "from": sender, "body": body}).json()

# Send bulk SMS
def send_bulk(recipients, body, sender="MyApp"):
    return requests.post(f"{BASE}/sms/bulk", headers=HEADERS,
        json={"recipients": recipients, "from": sender, "body": body}).json()

# Check balance
def get_balance():
    return requests.get(f"{BASE}/billing/balance", headers=HEADERS).json()

# List messages
def list_messages(status=None, page_size=50):
    params = {"page_size": page_size}
    if status: params["status"] = status
    return requests.get(f"{BASE}/reports/messages", headers=HEADERS, params=params).json()

# Usage:
print(send_sms("+447700900123", "Hello!"))
print(get_balance()["data"]["balance"])
msgs = list_messages(status="delivered")

const BASE = "https://app.bulksmsrates.com/v1";
const HEADERS = {
  "Content-Type": "application/json",
  "X-API-Key": process.env.BULKSMS_API_KEY,
  "X-API-Secret": process.env.BULKSMS_API_SECRET,
};

const api = {
  // Send single SMS
  async sendSms(to, body, from = "MyApp") {
    const res = await fetch(`${BASE}/sms/send`, {
      method: "POST", headers: HEADERS,
      body: JSON.stringify({ to, from, body }),
    });
    return res.json();
  },

  // Send bulk SMS
  async sendBulk(recipients, body, from = "MyApp") {
    const res = await fetch(`${BASE}/sms/bulk`, {
      method: "POST", headers: HEADERS,
      body: JSON.stringify({ recipients, from, body }),
    });
    return res.json();
  },

  // Get balance
  async getBalance() {
    const res = await fetch(`${BASE}/billing/balance`, { headers: HEADERS });
    return res.json();
  },

  // List messages
  async listMessages(params = {}) {
    const qs = new URLSearchParams(params).toString();
    const res = await fetch(`${BASE}/reports/messages?${qs}`, { headers: HEADERS });
    return res.json();
  },
};

// Usage:
const result = await api.sendSms("+447700900123", "Hello!");
console.log(result.data.message_id);

const { data } = await api.getBalance();
console.log(`Balance: £${(data.balance / 100).toFixed(2)}`);

<?php

class BulkSMSRates {
    private string $base = 'https://app.bulksmsrates.com/v1';
    private array $headers;

    public function __construct(string $apiKey, string $apiSecret) {
        $this->headers = [
            'Content-Type: application/json',
            "X-API-Key: {$apiKey}",
            "X-API-Secret: {$apiSecret}",
        ];
    }

    private function request(string $method, string $path, array $data = []): array {
        $ch = curl_init("{$this->base}{$path}");
        curl_setopt_array($ch, [
            CURLOPT_CUSTOMREQUEST => $method,
            CURLOPT_HTTPHEADER => $this->headers,
            CURLOPT_RETURNTRANSFER => true,
        ]);
        if ($data && $method !== 'GET') {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
        return json_decode(curl_exec($ch), true);
    }

    public function sendSms(string $to, string $body, string $from = 'MyApp'): array {
        return $this->request('POST', '/sms/send', compact('to', 'from', 'body'));
    }

    public function sendBulk(array $recipients, string $body, string $from = 'MyApp'): array {
        return $this->request('POST', '/sms/bulk', compact('recipients', 'from', 'body'));
    }

    public function getBalance(): array {
        return $this->request('GET', '/billing/balance');
    }

    public function listMessages(array $params = []): array {
        $qs = http_build_query($params);
        return $this->request('GET', "/reports/messages?{$qs}");
    }
}

// Usage:
$sms = new BulkSMSRates($_ENV['API_KEY'], $_ENV['API_SECRET']);
$result = $sms->sendSms('+447700900123', 'Hello!');
echo $result['data']['message_id'] . PHP_EOL;

$balance = $sms->getBalance()['data'];
echo "Balance: " . ($balance['balance'] / 100) . " " . $balance['currency'];