Bulk SMS API
Send SMS messages to multiple recipients at once and track delivery reports.
Send Bulk SMS
Send SMS messages to multiple recipients at once. Pricing is per page (160 characters).
POST
https://suruleredatacom.com.ng/api/bulk-sms
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| subject | String | Yes | Sender name (shown as sender ID). |
| bulkPhones | String | Yes | Comma-separated phone numbers. |
| message | String | Yes | SMS message content. |
curl -X POST "https://suruleredatacom.com.ng/api/bulk-sms" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"subject": "VICOM",
"bulkPhones": "08012345678,08123456789",
"message": "Your OTP code is 123456."
}'<?php
$url = 'https://suruleredatacom.com.ng/api/bulk-sms';
$payload = [
'subject' => 'VICOM',
'bulkPhones' => '08012345678,08123456789',
'message' => 'Your OTP code is 123456.'
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_HTTPHEADER => [
'Authorization: Token YOUR_API_KEY',
'Content-Type: application/json',
]
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
?>const response = await fetch('https://suruleredatacom.com.ng/api/bulk-sms', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
subject: 'VICOM',
bulkPhones: '08012345678,08123456789',
message: 'Your OTP code is 123456.'
})
});
const data = await response.json();
console.log(data);import requests
url = "https://suruleredatacom.com.ng/api/bulk-sms"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"subject": "VICOM",
"bulkPhones": "08012345678,08123456789",
"message": "Your OTP code is 123456."
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())Responses
✓ 200 OK
{
"status": "success",
"message": "Bulk SMS sent. Sender: VICOM. 159 page(s).",
"request-id": "SMS_66bfd5cd92079",
"amount": 398,
"subject": "VICOM",
"old_balance": 6882,
"new_balance": 6484
}SMS Report
Fetch SMS delivery report for a given sms_id.
GET
https://suruleredatacom.com.ng/api/sms-report?sms_id=SMS|F8D725DC-6A39...
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| sms_id | String | Yes | SMS transaction reference ID. |
curl -X GET "https://suruleredatacom.com.ng/api/sms-report?sms_id=SMS|F8D725DC-6A39-43D9-A7E0-20B90D10B798" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json"<?php
$url = 'https://suruleredatacom.com.ng/api/sms-report?sms_id=SMS|F8D725DC-6A39-43D9-A7E0-20B90D10B798';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Token YOUR_API_KEY',
'Content-Type: application/json',
]
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
?>const response = await fetch('https://suruleredatacom.com.ng/api/sms-report?sms_id=SMS|F8D725DC-6A39-43D9-A7E0-20B90D10B798', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
url = "https://suruleredatacom.com.ng/api/sms-report?sms_id=SMS|F8D725DC-6A39-43D9-A7E0-20B90D10B798"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())Responses
✓ 200 OK
{
"status": true,
"data": [
{
"id": "6057",
"user_id": "09103",
"number": "234810000888",
"sms_id": "019f0a38-cafd-73fd-ac5b-e475e7ff98c6",
"page": "2",
"transref": "SMS|F8D725DC-6A39-43D9-A7E0-20B90D10B798",
"status": "delivered",
"created_at": "2026-06-27 18:55:22",
"updated_at": "2026-06-27 18:55:36"
}
]
}