Quick start
Create an account
Sign up and get your API keys for sandbox and production environments.
Connect a gateway device
Install SelfSim Gateway on your Android SIM phone and pair it to your account.
Send your first task
Use the API to dispatch a task. The gateway device executes it on the SIM.
Receive webhook callback
SelfSimApp calls your callback URL with the signed result when the task completes.
curl -X POST https://api.selfSimapp.com/v1/tasks \
-H "Authorization: Bearer ssk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_reference": "ORDER-10001",
"task_type": "SEND_AIRTIME",
"network": "MTN",
"recipient_phone": "024XXXXXXX",
"amount": "5.00",
"device_group": "mtn-evd",
"callback_url": "https://example.com/webhooks/selfsim"
}'API Keys
Create scoped API keys for sandbox and production. Set permissions per key.
Webhooks
Receive signed webhook events for task status changes, payments, and device state.
API Logs
Full request/response logs with latency, status codes, and request IDs.
Sandbox Mode
Test all task types in a simulated environment without executing on real SIMs.
SDK Support
Client libraries for PHP/Laravel, Node.js, and Python. cURL examples included.
Docs & Error Codes
Comprehensive API reference with error codes, device groups, and flow types.