Smart Dial Developer Portal

Overview

Smart Dial’s USSD API enables businesses to integrate interactive, app-free services. You can manage sessions, menus, and responses in real-time, delivering fast and reliable communication to your users across all networks.

POST /api/ussd

Send USSD requests to our API and receive menu responses instantly. Ideal for interactive services, surveys, and session-based operations.

curl -X POST /api/ussd \
-H "Content-Type: application/json" \
-d '{"sessionId":"abc123","identifier":"254712345678","input":"1"}'

fetch("/api/ussd", {
  method:"POST",
  headers: {"Content-Type":"application/json"},
  body: JSON.stringify({sessionId:"abc123",identifier:"254712345678",input:"1"})
}).then(r=>r.json()).then(console.log);

$ch = curl_init("/api/ussd");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["sessionId"=>"abc123","identifier"=>"254712345678","input"=>"1"]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type:application/json"]);
$response = curl_exec($ch); curl_close($ch);

POST /api/ussd/key

Generate or retrieve your API key securely. Each key is unique to your account and allows you to make authenticated USSD requests.

{
  "company": "YourCompany"
}

{
  "api_key": "SMD123456789"
}

GET /api/ussd/session

Retrieve the details of an ongoing or completed USSD session, including user inputs, session history, and provider shortcode.

GET /api/ussd/session?sessionId=abc123

{
  "sessionId": "abc123",
  "history": ["1","2"],
  "provider": "*123#"
}

Try It Now