Bulk SMS API Nigeria

Powerful REST API for developers to integrate bulk SMS into their applications. Complete documentation with code examples in multiple languages.

Get Your Free API Token Already have an account? Login

Ready-to-Use Code Examples

Skip the setup! Get complete, production-ready code examples in PHP, Python, JavaScript, Node.js, and more. Plus download our Postman collections to test instantly.

🐘 PHP Laravel 🐍 Python 🟢 Node.js 🌐 JavaScript 🔧 cURL 📮 Postman

View Code Examples

Quick Start Guide

Sign Up & Get API Token

Choose Your Language

Use our code examples in PHP, Python, JavaScript, or cURL

Start Sending SMS

Make your first request and start sending bulk SMS

Base URL

All API requests should be made to the following base URLs:

Production API

https://www.bulksmsnigeria.com/api/v2

Sandbox API (Testing)

https://www.bulksmsnigeria.com/api/sandbox/v2

SANDBOX

Test Environment

Use our sandbox environment to test your integration without sending real SMS messages or consuming your wallet balance.

No Real SMS Sent

Messages are simulated - no actual SMS delivered

Zero Cost

Your wallet balance is never deducted

Same API Structure

Identical request/response format

Available Sandbox Endpoints

Endpoint	Method	Description
`/api/sandbox/v2/sms`	POST/GET	Send test SMS (simulated)
`/api/sandbox/v2/balance`	GET	Check account balance
`/api/sandbox/v2/delivery-reports`	GET	List delivery reports
`/api/sandbox/v2/sender-ids`	GET	List registered sender IDs
`/api/sandbox/v2/account`	GET	Get account information

Note: Sandbox uses the same API token as production. Rate limit: 120 requests/minute.

Authentication

Our API accepts authentication tokens in multiple ways for maximum flexibility. The recommended method is using the Authorization header:

RECOMMENDED

Authorization Header

Authorization: Bearer YOUR_API_TOKEN

Custom Header

api_token: YOUR_API_TOKEN

Query Parameter

?api_token=YOUR_API_TOKEN

Request Body

{"api_token": "YOUR_API_TOKEN"}

POST Send Bulk SMS

Send bulk SMS messages to one or multiple recipients across all Nigerian networks

Endpoints

/api/v2/sms Recommended

/api/v1/sms/create Legacy

Request Parameters

Parameter	Type	Required	Description
`from`	string	Required	Sender ID (max 11 characters)
`to`	string	Required	Comma-separated phone numbers (e.g., 2347012345678,2348012345678)
`body`	string	Required	Message content (up to 1530 characters)
`gateway`	string	Optional	Gateway: direct-refund, direct-corporate, otp, dual-backup
`callback_url`	string	Optional	URL for delivery status callbacks/webhooks

Code Examples

curl -X POST https://www.bulksmsnigeria.com/api/v2/sms \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "from": "YourCompany",
    "to": "2347012345678,2348012345678",
    "body": "Hello from BulkSMS Nigeria API! Welcome to our service.",
    "gateway": "direct-refund"
  }'

<?php
$apiToken = 'YOUR_API_TOKEN';
$url = 'https://www.bulksmsnigeria.com/api/v2/sms';

$data = [
    'from' => 'YourCompany',
    'to' => '2347012345678,2348012345678',
    'body' => 'Hello from BulkSMS Nigeria API!',
    'gateway' => 'direct-refund'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiToken,
    'Content-Type: application/json',
    'Accept: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

import requests
import json

api_token = 'YOUR_API_TOKEN'
url = 'https://www.bulksmsnigeria.com/api/v2/sms'

headers = {
    'Authorization': f'Bearer {api_token}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

data = {
    'from': 'YourCompany',
    'to': '2347012345678,2348012345678',
    'body': 'Hello from BulkSMS Nigeria API!',
    'gateway': 'direct-refund'
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)

const apiToken = 'YOUR_API_TOKEN';
const url = 'https://www.bulksmsnigeria.com/api/v2/sms';

const data = {
    from: 'YourCompany',
    to: '2347012345678,2348012345678',
    body: 'Hello from BulkSMS Nigeria API!',
    gateway: 'direct-refund'
};

fetch(url, {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${apiToken}`,
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

Success Response

{
  "status": "success",
  "code": "BSNG-0000",
  "message": "Message sent successfully",
  "data": {
    "message_id": "a22f907b-c5aa-44e4-89e4-06fe253e9cbb",
    "cost": 5.00,
    "currency": "NGN",
    "recipients_count": 2,
    "gateway_used": "direct-refund"
  }
}

GET Check Account Balance

Check your current SMS credit balance

Endpoint

/api/v2/balance

Example Request

curl -X GET https://www.bulksmsnigeria.com/api/v2/balance \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response

{
  "data": {
    "status": "success",
    "message": "Balance Inquiry Successful"
  },
  "balance": {
    "total_balance": 9884.24,
    "universal_wallet": "9879.23",
    "sms_wallet": "5.01",
    "sms_bonus": "0.00"
  }
}

GET Fetch Delivery Reports

Get per-recipient delivery statuses for a sent message

Endpoint

/api/v2/delivery-reports

Parameters

Parameter	Required	Description
`message_id`	Yes	The message_id returned when the message was sent
`page`	No	Page number, defaults to 1
`per_page`	No	Results per page, defaults to 100 (max 1000)

Example Request

curl -X GET "https://www.bulksmsnigeria.com/api/v2/delivery-reports?message_id=YOUR_MESSAGE_ID" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response

{
  "status": "success",
  "code": "BSNG-0000",
  "message": "Delivery report retrieved",
  "data": {
    "message_id": "a22f907b-c5aa-44e4-89e4-06fe253e9cbb",
    "summary": {"total": 3, "delivered": 2, "pending": 1, "failed": 0},
    "reports": [
      {"recipient": "2347037770033", "delivery_status": "delivrd"},
      {"recipient": "2348012345678", "delivery_status": "delivrd"},
      {"recipient": "2349050030090", "delivery_status": "sent awaiting status"}
    ],
    "pagination": {"current_page": 1, "per_page": 100, "total": 3, "last_page": 1}
  }
}

GET List Sender IDs

List your registered sender IDs and their approval status

Endpoint

/api/v2/sender-ids

Example Request

curl -X GET https://www.bulksmsnigeria.com/api/v2/sender-ids \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response

{
  "status": "success",
  "code": "BSNG-0000",
  "message": "Sender IDs retrieved",
  "data": {
    "sender_ids": [
      {"sender_id": "MyBrand", "status": "approved", "purpose": "Transactional alerts", "approved_at": "2026-01-15 09:30:00", "rejection_reason": null}
    ],
    "total": 1
  }
}

GET Get Account Information

Retrieve your account profile, verification level, and balance

Endpoint

/api/v2/account

Example Request

curl -X GET https://www.bulksmsnigeria.com/api/v2/account \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response

{
  "status": "success",
  "code": "BSNG-0000",
  "message": "Account information retrieved",
  "data": {
    "user_id": "0f8e2a64-1bbb-4f3e-9c0d-5a3a1c2d4e5f",
    "email": "dev@example.com",
    "name": "Ada Developer",
    "account_status": "active",
    "verification_level": "verified",
    "balance": 10250.50,
    "currency": "NGN",
    "created_at": "2025-11-02 08:14:33"
  }
}

Ready to Integrate Our SMS API?

Get Started Free - 50 SMS Credits Contact Sales

Why Choose Our Bulk SMS API?

Instant Delivery

Messages delivered in seconds with 99.9% uptime guarantee

All Networks

Deliver to MTN, GLO, Airtel, 9mobile including DND numbers

Affordable Rates

Starting from ₦5.62 per SMS with volume discounts