HTTPS / JSON
HTTP REST API
A straightforward HTTP REST API in JSON, for teams that would rather not run a persistent SMPP session. Same routes, same balance, same receipts.
Get test credentialsThe HTTP API exists for teams whose platform is request-response rather than session-based, and for anyone who wants to send their first test message in five minutes rather than after an SMPP interop call.
It is the same routing
API traffic and SMPP traffic use the same routes, the same balance and the same reporting. The protocol is a deployment choice, not a product tier, and you can run both against one account.
Delivery receipts
Receipts are pushed to a webhook you nominate, with retries on failure, or you can poll a status endpoint if an inbound callback is awkward in your environment.
- Transport HTTPS, TLS 1.2 or above
- Format JSON request and response
- Authentication API key, optionally pinned to an IP allow-list
- Callbacks Delivery receipts pushed to your webhook, or polled
- Endpoints Send, status, balance, and voice OTP trigger
Get credentials
Credentials are issued with your test account, on the same routes production will use.
POST /v1/messages HTTP/1.1
Host: api.sisbird.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"to": "+8801XXXXXXXXX",
"from": "SISBIRD",
"text": "Your verification code is 472915",
"type": "otp",
"callback_url": "https://your-platform.example/dlr"
}