Preview: the API is being built and these endpoints may change
Overview
One API for airtime, data and more across Nigeria, through hosted SIMs and the channels you connect.
SimConnectNG takes one request, sends it through the healthiest channel on the right network, moves to another channel if that one stumbles, and tells you the final state through the response and a signed webhook. You pay a flat fee per delivered sale: it is held on your wallet when a request starts and settled or released when it ends.
Everything is plain JSON over HTTPS, with amounts in naira. Every response has the same shape: success, data, message and code.
Start here
- Quickstart: a test key, a test sale and a webhook, in a few minutes.
- Integrate with a coding agent: a prompt you can paste into your agent, and the files it should read.
How it works
- Test mode: build against test keys that never touch live money.
- Authentication: API keys, how to keep them safe and how to rotate them.
- Idempotency: repeat a request safely, never charge twice.
- Wallet: holds, settlement and the ledger.
- Webhooks: events, signatures and retries.
- Errors: the error shape and every code.
API reference
The base URL is https://api.simconnectng.com/api/v1. Every endpoint is listed under API reference in the menu, each with one request, one response and one error you can copy.
For agents
Every page is also available as plain markdown: add .md to its address. The full index is at /llms.txt, and every page in one file is at /llms-full.txt.