API Docs / Overview
Overview SMS Airtime Data Electricity Balance Network Lookup OpenAPI

SIMcloud API Documentation

This page is the master index for the SIMcloud API documentation.

The currently documented API services are SMS, airtime, data, electricity, wallet balance, and network lookup.

Authentication

All API services use Bearer token authentication.

Authorization: Bearer YOUR_API_TOKEN

To create or refresh your API token, use the SIMcloud token management page here: https://simcloud.co.za/sms_api_management.php

Generate and manage your API token from the SIMcloud portal, then use the same token across the supported API services below.

Machine-Readable Spec

For LLMs, agent tooling, and API client generation, use the raw OpenAPI spec:

https://simcloud.co.za/api/openapi.yaml

For browser viewing, use the rendered spec page: https://simcloud.co.za/api/openapi.php

Available Services

SMS API

Send SMS messages and query SMS delivery status.

Open SMS Documentation

Airtime API

Queue prepaid airtime purchases and poll the order status.

Open Airtime Documentation

Data API

Queue prepaid data bundle purchases and poll the order status.

Open Data Documentation

Electricity API

Submit prepaid electricity requests and poll the order until the municipality returns the final result.

Open Electricity Documentation

Balance API

Fetch the authenticated account's last known SIMcloud wallet balance.

Open Balance Documentation

Network Lookup API

Look up the mobile network for a South African cell number using token-based authentication.

Open Network Lookup Documentation

OpenAPI Spec

Machine-readable API contract for LLMs, tooling, and generated clients.

Open OpenAPI Spec

Service Summary

Documentation Links