# Dancity

## Docs

- [Fund betting account](https://docs.dancity.app/api-reference/betting/post-api-betting-funding.md): Fund betting account
- [Get cable plans](https://docs.dancity.app/api-reference/catalog/get-api-plans-cable.md): Returns cable plans with `planId` for POST /api/v1/cable/buy. Filter by product name (e.g. GOTV, DSTV).
- [Get data plans](https://docs.dancity.app/api-reference/catalog/get-api-plans-data.md): Returns data plans with `planId` for use in POST /api/v1/data/buy. Filter by product name when needed.
- [Get products](https://docs.dancity.app/api-reference/catalog/get-api-products.md): Fetch products. Filter by `service` (service name) when needed.
- [Get services](https://docs.dancity.app/api-reference/catalog/get-api-service.md): Returns all service categories.
- [Purchase education pin](https://docs.dancity.app/api-reference/education/post-api-education-pin-purchase.md): Purchase education pin
- [Get eSIM details](https://docs.dancity.app/api-reference/esim/get-api-esim-details-transactionId.md): Fetch QR code, ICCID, and activation status for an eSIM purchase
- [Fetch eSIMs](https://docs.dancity.app/api-reference/esim/get-api-esim-my-esims.md): List active eSIMs purchased on the merchant account (paginated)
- [eSIM packages for region](https://docs.dancity.app/api-reference/esim/get-api-esim-packages.md): eSIM packages for region
- [eSIM regions](https://docs.dancity.app/api-reference/esim/get-api-esim-regions.md): eSIM regions
- [Get top-up packages for ICCID](https://docs.dancity.app/api-reference/esim/get-api-esim-topup-packages.md): List add-on data packages for an existing eSIM using its ICCID
- [Purchase eSIM](https://docs.dancity.app/api-reference/esim/post-api-esim-purchase.md): Purchase eSIM
- [API reference](https://docs.dancity.app/api-reference/introduction.md): HTTP endpoints, request/response shapes, and Try it (OpenAPI)
- [Get transactions](https://docs.dancity.app/api-reference/transactions/get-api-transactions.md): Fetch the authenticated user’s transactions. Use `page`, `limit`, date range, `status`, `service`, `tranxType`, and other query params to filter. For a single row and up-to-date status, use `GET /api/transactions/{transactionId}`.
- [Requery transaction](https://docs.dancity.app/api-reference/transactions/get-api-transactions-transactionId.md): Return one transaction and its current `status` by Mongo `_id` or by `tranxId`. Use to requery after a purchase or for polling. Typical `status` values include `SUCCESS`, `FAILED`, `PROCESSING`, `PENDING`, `CANCELLED`.
- [Purchase airtime](https://docs.dancity.app/api-reference/v1/post-api-v1-airtime-buy.md): Purchase airtime
- [Cable subscription](https://docs.dancity.app/api-reference/v1/post-api-v1-cable-buy.md): Renew a cable TV subscription.
- [Validate Smartcard](https://docs.dancity.app/api-reference/v1/post-api-v1-cable-validate.md): Validate a cable TV smartcard or IUC number.
- [Purchase Data](https://docs.dancity.app/api-reference/v1/post-api-v1-data-buy.md): Purchase Data
- [Buy electricity token](https://docs.dancity.app/api-reference/v1/post-api-v1-electricity-buy.md): Vend prepaid electricity units or pay a postpaid bill.
- [Validate Meter](https://docs.dancity.app/api-reference/v1/post-api-v1-electricity-validate.md): Validate an electricity meter number.
- [Purchase internet bundle](https://docs.dancity.app/api-reference/v1/post-api-v1-internet-buy.md): Purchase internet bundle
- [Get wallets balance](https://docs.dancity.app/api-reference/wallet/get-api-wallet.md): Returns all wallets and balances for the user linked to this API key.
- [Outbound webhook to your server](https://docs.dancity.app/api-reference/webhooks/merchant-webhook.md): Transaction events Dancity POSTs to your configured HTTPS webhook URL
- [Airtime & data](https://docs.dancity.app/guides/airtime-data.md): Top up a phone number with airtime or a mobile data bundle
- [Authentication](https://docs.dancity.app/guides/authentication.md): How to authenticate with the Dancity merchant API
- [Betting wallet funding](https://docs.dancity.app/guides/betting.md): Top up a customer's betting account from your Dancity wallet
- [Cable TV](https://docs.dancity.app/guides/cable-tv.md): Validate a smartcard and renew a cable TV subscription
- [Products & services catalog](https://docs.dancity.app/guides/catalog.md): Browse services, products, and plans before making a purchase
- [Education pins](https://docs.dancity.app/guides/education-pins.md): Purchase exam scratch cards and result-checker PINs
- [Electricity](https://docs.dancity.app/guides/electricity.md): Validate a meter number and vend electricity tokens
- [Error Reference](https://docs.dancity.app/guides/errors.md): Understand every error the Dancity API can return
- [eSIM](https://docs.dancity.app/guides/esim.md): Browse regions and packages, purchase an eSIM, and manage active eSIMs
- [Internet](https://docs.dancity.app/guides/internet.md): Purchase broadband and fixed internet bundles for an account
- [Rate Limits](https://docs.dancity.app/guides/rate-limits.md): Understanding request limits and how to handle throttling
- [Transactions](https://docs.dancity.app/guides/transactions.md): Query your transaction history and recheck the status of individual purchases
- [Wallet](https://docs.dancity.app/guides/wallet.md): Check your Dancity wallet balances via the merchant API
- [Webhooks](https://docs.dancity.app/guides/webhook.md): Receive real-time transaction events Dancity sends to your webhook URL
- [Quickstart](https://docs.dancity.app/index.md): Build VAS and payment integrations with the Dancity merchant API

## OpenAPI Specs

- [openapi](https://docs.dancity.app/api-reference/openapi.json)

## Optional

- [Dashboard](https://dancity.app)
- [Support](mailto:support@dancity.app)