REST API v1 & Operator Gateway Sub-second Burundi Routing

Operator & Developer API Reference

Empower your development team to build directly across the OmniSMS carrier infrastructure. Connect core banking, ERPs, fintechs, and web/mobile apps with high-throughput JSON endpoints, interactive sandboxes, and carrier-grade SLAs.

BASE URL: https://smsplatform.deventtechnology.com/api/v1

HTTPS & Bearer Token Authentication

Dev Navigation

⚡ Interactive API Sandbox LIVE 1. Operator & Carrier Architecture 2. Authentication & Keys 3. Send Single SMS / OTP POST 4. Send Bulk Campaign POST 5. Message Status & DLR GET 6. Wallet Balance GET 7. Inbound DLR Webhooks EVENT 8. Multi-Language SDK Snippets

Get Production API Key Customer Key Console

Interactive Dev Console

Live Operator API Test Sandbox

Simulate real-time requests, test payloads, and examine response latency and headers.

Simulated Mode: Active

Select Endpoint to Test

Approved Sender ID (Header)

Destination Mobile (Burundi +257)

SMS Route / Category

Message Content

Authentication: Bearer sms_live_9f8382...

Console Response Output

200 OK Latency: 118ms Operator: Econet + Lumitel Direct

{
  "success": true,
  "message_id": "MSG_BDI_998124",
  "provider": "telecom_direct_burundi",
  "operator_route": "Econet Leo (+257)",
  "status": "DELIVRD",
  "recipient": "+25779123456",
  "parts": 1,
  "cost": 0.025,
  "currency": "USD",
  "timestamp": "2026-09-08T10:50:00Z"
}

Carrier Infrastructure

1. Operator & Telecom Gateway Architecture

OmniSMS operates carrier-grade SMPP v3.4 interconnects and high-capacity HTTP REST adapters directly with telecommunication networks in Burundi (Econet Leo +257 79/71 and Lumitel / Viettel +257 69/68/61) as well as global aggregators (MSG91).

Econet Leo Route

Prefixes: +257 79, +257 71, +257 76 Latency: < 850ms OTP

Lumitel Burundi Route

Prefixes: +257 69, +257 68, +257 61 Latency: < 920ms OTP

Global Aggregator

190+ Countries wholesale Throughput: 1,000 req/sec

2. Authentication & Headers

Authenticate all REST API requests by including your private API key in the HTTP Authorization header as a Bearer token or using the X-API-KEY header.

Authorization: Bearer sms_live_9f83820a1b2c3d4e5f6a7b8c
Content-Type: application/json
Accept: application/json

POST

/api/v1/sms/send

Dispatches an instant single SMS (OTP, security verification, or notification).

Payload Example JSON

// POST https://smsplatform.deventtechnology.com/api/v1/sms/send { "sender_id": "BANCOBU", // Required: Approved Header "mobile": "+25779123456", // Required: E.164 phone format "message": "Your OTP is 492810.", // Required: UTF-8 message "type": "otp", // Optional: otp, transactional, promotional "template_id": "TPL_OTP_01" // Optional: Registered template }

POST

/api/v1/sms/bulk-send

Broadcast up to 1,000 customized SMS messages per API call with per-recipient variable tag mapping.

{ "sender_id": "BANCOBU", "message": "Hello {name}, your monthly statement balance is BIF {amount}.", "type": "transactional", "recipients": [ { "mobile": "+25779111222", "variables": { "name": "Jean-Paul", "amount": "450,000" } }, { "mobile": "+25779333444", "variables": { "name": "Marie", "amount": "1,200,000" } } ] }

GET

/api/v1/sms/status/{message_id}

Query real-time delivery status, operator timestamp, and handset delivery receipt.

GET

/api/v1/balance

Check organization floating wallet balance and estimated SMS credits.

7. Real-Time Inbound DLR Webhooks

Configure your webhook endpoint in your Customer Portal. Our gateway will post JSON notifications as carrier handshakes confirm SMS delivery.

{ "message_id": "MSG_BDI_998124", "mobile": "+25779123456", "status": "DELIVRD", "operator": "Econet_Leo_Burundi", "delivered_at": "2026-09-08T10:50:02Z" }

8. Multi-Language SDK Snippets

Copy-paste ready implementations for your tech stack.