API documentation

require __DIR__ . '/vendor/autoload.php';

use Swiftsms\Swiftsmsgh;
use Swiftsms\SwiftsmsException;

$client = new Swiftsmsgh('YOUR_API_TOKEN', 'YourSenderID');

try {
    // Comma-separate multiple recipients
    $response = $client->send_sms('233538000000,233540000000', 'Hello from SWIFT SMS!');

    // Optional: schedule and override the sender ID
    $client->send_sms('233538000000', 'See you tomorrow', [
        'schedule_time' => '2026-12-25 08:00',
        'sender_id'     => 'MyAlert',
    ]);
} catch (SwiftsmsException $e) {
    echo 'Error: ' . $e->getMessage();
}

// Reads SWIFTSMS_API_TOKEN and SWIFTSMS_SENDER_ID from the environment
const client = require('swiftsmsgh-api-sdk')();

// A single number, or an array of numbers
await client.sms.send(['233538000000', '233540000000'], 'Hello from SWIFT SMS!');

// Optional: schedule and override the sender ID
await client.sms.send('233538000000', 'See you tomorrow', {
  schedule_time: '2026-12-25 08:00',
  sender_id: 'MyAlert',
});

import swiftsmsgh, { SwiftsmsException } from 'swiftsmsgh-api-sdk';

const client = swiftsmsgh(process.env.SWIFTSMS_API_TOKEN, process.env.SWIFTSMS_SENDER_ID, {
  autoRetry: true, // retry failed requests with exponential backoff
  maxRetries: 3,
});

try {
  const { data } = await client.account.balance();
  console.log(data?.remaining_balance);
} catch (error) {
  if (error instanceof SwiftsmsException) {
    console.error(`API error ${error.code}: ${error.message} (HTTP ${error.status})`);
  }
}

curl -X POST https://swiftsmsgh.com/api/v3/sms/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "recipient": "233241234567",
    "sender_id": "YourName",
    "type": "plain",
    "message": "This is a test message"
  }'

$ch = curl_init('https://swiftsmsgh.com/api/v3/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_TOKEN',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'recipient' => '233241234567',
        'sender_id' => 'YourName',
        'type'      => 'plain',
        'message'   => 'This is a test message',
    ]),
]);
$response = json_decode(curl_exec($ch), true);

const res = await fetch('https://swiftsmsgh.com/api/v3/sms/send', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    recipient: '233241234567',
    sender_id: 'YourName',
    type: 'plain',
    message: 'This is a test message',
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://swiftsmsgh.com/api/v3/sms/send",
    headers={"Authorization": "Bearer YOUR_API_TOKEN", "Accept": "application/json"},
    json={
        "recipient": "233241234567",
        "sender_id": "YourName",
        "type": "plain",
        "message": "This is a test message",
    },
)
data = res.json()

curl -X POST https://swiftsmsgh.com/api/v3/sms/campaign \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "recipient": "6415907d0d37a",
    "sender_id": "YourName",
    "type": "plain",
    "message": "Our weekend sale is live!",
    "schedule_time": "2026-12-20 07:00"
  }'

https://swiftsmsgh.com/api/http/sms/send?recipient=233241234567&sender_id=YourName&type=plain&message=Hello&api_token=YOUR_API_TOKEN