Overview
Nigerian SIM Hosting Control Center
sh_live_••••••••••••••••
Total Sims Hosted
4
SIMs Online
3
USSD Success Rate
98.7%
SMS Dispatched Today
0
SIM Gateway Slots Status
GSM Gateway ActiveSystem Event Stream
| Slot | Provider | Phone Number | Airtime Bal (NGN) | Data Balance | Signal Strength | Status | Actions |
|---|
Execute USSD Dialing Session
Simhost Active Gateway
USSD Transmission logs (Session Log)
| Ref ID | SIM Slot | Dial Code | Status | Response Text | Time taken | Timestamp |
|---|---|---|---|---|---|---|
| No logs recorded yet. Run a USSD code. | ||||||
Send Outgoing SMS
SMS Inbox & Outbox Messages
Add Webhook Listener
Set up HTTP POST endpoints to receive real-time webhook callbacks. Whenever an incoming SMS is received or a background USSD request completes, we'll notify your system instantly.
Active Webhook Configuration
Recent Webhook Dispatch Attempts
Gateway API Integration Guide
Automate USSD execution, SMS relays, and balance monitors by integrating our simple API into your application backend. Below are code samples configured with your active API key and local server URL.
1. Execute USSD Dial (Synchronous)
curl -X POST http://localhost:3000/api/ussd/send \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"sim_id": 1,
"ussd_code": "*310#",
"async": false
}'
2. Send Outgoing SMS
curl -X POST http://localhost:3000/api/sms/send \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"sim_id": 1,
"to": "08030000000",
"message": "Hello from Simhost platform!"
}'
1. Execute USSD Dial (Synchronous)
const apiKey = 'YOUR_API_KEY';
fetch('http://localhost:3000/api/ussd/send', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': apiKey
},
body: JSON.stringify({
sim_id: 1,
ussd_code: '*310#',
async: false
})
})
.then(res => res.json())
.then(data => console.log('USSD response:', data.response))
.catch(err => console.error(err));
2. Send Outgoing SMS
fetch('http://localhost:3000/api/sms/send', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': apiKey
},
body: JSON.stringify({
sim_id: 1,
to: '08030000000',
message: 'Hello from Simhost platform!'
})
})
.then(res => res.json())
.then(data => console.log('SMS sent successfully, status:', data.message));
1. Execute USSD Dial (Synchronous)
import requests
api_key = "YOUR_API_KEY"
url = "http://localhost:3000/api/ussd/send"
payload = {
"sim_id": 1,
"ussd_code": "*310#",
"async": False
}
headers = {
"Content-Type": "application/json",
"x-api-key": api_key
}
response = requests.post(url, json=payload, headers=headers)
print(response.json()["response"])
2. Send Outgoing SMS
sms_url = "http://localhost:3000/api/sms/send"
sms_payload = {
"sim_id": 1,
"to": "08030000000",
"message": "Hello from Simhost platform!"
}
response = requests.post(sms_url, json=sms_payload, headers=headers)
print(response.json()["message"])
GSM SIM Hardware Hardware Injection Panel
Interact with the GSM Gateway emulator here. Trigger incoming SMS text notifications (like OTP warnings, cash transfer alerts) or simulate signal dropouts to verify how your API handles outages.