API Docs / Network Lookup

Network Lookup API Documentation

Base URL

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

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Endpoint

GET

Returns the detected network for the supplied South African mobile number.

Each lookup is logged against the authenticated account.

Query Parameters

Parameter Type Required Description
msisdn string Yes South African mobile number to check.

Example Request

GET https://simcloud.co.za/api/network.php?msisdn=0821234567

Success Response

{
    "status": "success",
    "msisdn": "+27821234567",
    "network": "mtn"
}

Error Codes

Code Description
400 Bad Request (missing or invalid msisdn)
401 Unauthorized (invalid or missing token)
404 The number does not match any network
405 Method not allowed