# SimConnectNG

> One API for airtime, data and more across Nigeria, through hosted SIMs and the channels you connect. Plain JSON over HTTPS, amounts in naira. The API is in preview and may change.

## Get started

- [Overview](https://simconnectng.com/docs.md): One API for airtime, data and more across Nigeria, through hosted SIMs and the channels you connect.
- [Quickstart](https://simconnectng.com/docs/quickstart.md): A test key, a test sale and a signed webhook, in a few minutes.
- [Integrate with a coding agent](https://simconnectng.com/docs/agents.md): The prompt to paste into your coding agent, and the files it should read.
- [Changelog](https://simconnectng.com/docs/changelog.md): Every change to the API, newest first.

## Concepts

- [Test mode](https://simconnectng.com/docs/concepts/test-mode.md): Build against test keys that never touch live money or live networks.
- [Authentication](https://simconnectng.com/docs/concepts/authentication.md): API keys, how to keep them safe, and how to rotate them without downtime.
- [Idempotency](https://simconnectng.com/docs/concepts/idempotency.md): Repeat a request safely. The same key always gives the same answer and never a second charge.
- [Wallet](https://simconnectng.com/docs/concepts/wallet.md): Holds, settlement and the ledger behind every sale.
- [Webhooks](https://simconnectng.com/docs/concepts/webhooks.md): Events, signatures and retries.
- [Errors](https://simconnectng.com/docs/concepts/errors.md): The error shape and every code you can get back.
- [Rate limits](https://simconnectng.com/docs/concepts/rate-limits.md): How limits are applied, and what to do when you hit one.

## API reference

- [Send airtime](https://simconnectng.com/docs/api/send-airtime.md): Top up any Nigerian number on MTN, Airtel, Glo or 9mobile.
- [List plans](https://simconnectng.com/docs/api/list-data-plans.md): The plans on sale for each network, with their face value and the flat fee per sale.
- [Buy data](https://simconnectng.com/docs/api/buy-data.md): Send a data plan to any Nigerian number.
- [Get a transaction](https://simconnectng.com/docs/api/get-transaction.md): One sale, its current state and its full timeline.
- [List transactions](https://simconnectng.com/docs/api/list-transactions.md): Your sales, newest first, with filters and pages.
- [Get wallet](https://simconnectng.com/docs/api/get-wallet.md): Your balance, what is held, and what is available.
- [List channels](https://simconnectng.com/docs/api/list-channels.md): Every line you sell through, with its credit and health.
- [List networks](https://simconnectng.com/docs/api/list-networks.md): The networks you can sell on right now.

Every page in one file: https://simconnectng.com/llms-full.txt