Overview SMS Airtime Data Electricity Balance Network Lookup OpenAPI

Balance API Documentation

Base URL

https://simcloud.co.za/api/balance.php

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Endpoint

GET

Returns the authenticated account's current last known SIMcloud wallet balance.

This endpoint returns the stored last known balance for the authenticated account.

Example Request

GET https://simcloud.co.za/api/balance.php

Success Response

{
    "status": "success",
    "user_id": 123,
    "username": "4250521",
    "name": "John Smith",
    "balance": 5879.33,
    "updated_at": "2026-04-16 17:00:00"
}

Error Codes

Code Description
401 Unauthorized (invalid or missing token)
405 Method not allowed