Overview

Nigerian SIM Hosting Control Center

API KEY: sh_live_••••••••••••••••

Total Sims Hosted

4

SIMs Online

3

USSD Success Rate

98.7%

SMS Dispatched Today

0

SIM Gateway Slots Status

GSM Gateway Active

System Event Stream

[2026-06-05 10:48:00] SIM Host server initialised.
[2026-06-05 10:48:01] Loaded SIM Profile: MTN (08031111111) in Slot 1.
[2026-06-05 10:48:01] Loaded SIM Profile: Airtel (08022222222) in Slot 2.
[2026-06-05 10:48:01] Loaded SIM Profile: 9mobile (08094444444) in Slot 4.
[2026-06-05 10:48:02] GSM hardware emulation running on localhost:3000
Slot Provider Phone Number Airtime Bal (NGN) Data Balance Signal Strength Status Actions

Execute USSD Dialing Session

10:48
MTN-NG
10:48
Friday, June 5

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

Charges: NGN 4.00 per SMS deduction from airtime balance.

SMS Inbox & Outbox Messages

No messages found.

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.

Must be a valid HTTP/HTTPS endpoint. For local development, use Ngrok or a public URL.
Payloads are signed with this key via HMAC SHA256 header X-Simhost-Signature.

Active Webhook Configuration

No webhooks configured.

Recent Webhook Dispatch Attempts

No webhook execution logs.

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.

Inject Incoming SMS to a SIM Card

Carrier Network Signals & Hardware Variables

Simulate Telco Signal Strength & State

No Signal Poor Excellent

By injecting a **Recharge SMS** (e.g. including the word Recharge of N5,000), the system auto-updates the airtime balance of the SIM in the database, allowing you to test data plan purchases or balance inquiries dynamically!