Skip to main content

GlobalSIM API Overview

WAYSCloud GlobalSIM provides worldwide SIM card provisioning and management with coverage across 685+ mobile networks in 160+ countries.

Key Features​

  • Global coverage across 685+ networks in 160+ countries
  • Digital SIM provisioning via API
  • Real-time tracking of data usage and connectivity
  • Session and activity monitoring
  • IoT device integration

Base URL​

https://api.wayscloud.services/v1/globalsim

Authentication​

All requests require a valid API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Quick Start​

List Your SIM Cards​

curl -X GET https://api.wayscloud.services/v1/globalsim/sims \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "sims": [
    {
      "iccid": "8901234567890123456",
      "status": "active",
      "msisdn": "+4791234567",
      "current_network": {
        "country": "Norway",
        "operator": "Telenor Norway",
        "network_code": "24201"
      },
      "data_usage_mb": 125.4,
      "activated_at": "2025-10-15T10:00:00Z"
    }
  ],
  "total": 1
}

Get SIM Details​

curl -X GET https://api.wayscloud.services/v1/globalsim/sims/8901234567890123456 \
  -H "Authorization: Bearer YOUR_API_KEY"

Order New SIM Cards​

curl -X POST https://api.wayscloud.services/v1/globalsim/sims/order \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 10
  }'

Check Available Networks​

curl -X GET https://api.wayscloud.services/v1/globalsim/sims/networks \
  -H "Authorization: Bearer YOUR_API_KEY"

Monitor Data Usage​

curl -X GET https://api.wayscloud.services/v1/globalsim/sims/8901234567890123456/sessions \
  -H "Authorization: Bearer YOUR_API_KEY"

Python Quick Start​

import requests
import os

API_KEY = os.getenv('WAYSCLOUD_API_KEY')
API_URL = 'https://api.wayscloud.services/v1/globalsim'

def list_sims():
    headers = {'Authorization': f'Bearer {API_KEY}'}

    response = requests.get(
        f'{API_URL}/sims',
        headers=headers
    )

    sims = response.json()

    for sim in sims['sims']:
        print(f"ICCID: {sim['iccid']}")
        print(f"Status: {sim['status']}")
        print(f"Number: {sim.get('msisdn', 'Not assigned')}")
        print(f"Data used: {sim['data_usage_mb']:.2f} MB")
        print("---")

def get_sim_details(iccid):
    headers = {'Authorization': f'Bearer {API_KEY}'}

    response = requests.get(
        f'{API_URL}/sims/{iccid}',
        headers=headers
    )

    return response.json()

def check_data_usage(iccid):
    headers = {'Authorization': f'Bearer {API_KEY}'}

    response = requests.get(
        f'{API_URL}/sims/{iccid}/sessions',
        headers=headers
    )

    sessions = response.json()

    total_data = sum(s.get('data_usage_mb', 0) for s in sessions.get('sessions', []))
    print(f"Total data usage: {total_data:.2f} MB")

    return sessions

if __name__ == '__main__':
    list_sims()

Node.js Quick Start​

const axios = require('axios');

const API_KEY = process.env.WAYSCLOUD_API_KEY;
const API_URL = 'https://api.wayscloud.services/v1/globalsim';

async function listSims() {
  try {
    const response = await axios.get(`${API_URL}/sims`, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`
      }
    });

    const sims = response.data.sims;

    sims.forEach(sim => {
      console.log(`ICCID: ${sim.iccid}`);
      console.log(`Status: ${sim.status}`);
      console.log(`Number: ${sim.msisdn || 'Not assigned'}`);
      console.log(`Data: ${sim.data_usage_mb.toFixed(2)} MB`);
      console.log('---');
    });

    return sims;
  } catch (error) {
    console.error('Error:', error.message);
  }
}

async function getSimSessions(iccid) {
  try {
    const response = await axios.get(
      `${API_URL}/sims/${iccid}/sessions`,
      {
        headers: { 'Authorization': `Bearer ${API_KEY}` }
      }
    );

    return response.data;
  } catch (error) {
    console.error('Error:', error.message);
  }
}

async function orderSims(quantity) {
  try {
    const response = await axios.post(
      `${API_URL}/sims/order`,
      { quantity: quantity },
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );

    console.log('Order placed:', response.data);
    return response.data;
  } catch (error) {
    console.error('Order failed:', error.message);
  }
}

(async () => {
  await listSims();
})();

API Endpoints Overview​

SIM Management​

  • GET /v1/globalsim/sims - List all SIM cards
  • GET /v1/globalsim/sims/{iccid} - Get SIM details
  • POST /v1/globalsim/sims/order - Order new SIM cards
  • GET /v1/globalsim/sims/networks - List available networks

Activity & Sessions​

  • GET /v1/globalsim/sims/{iccid}/sessions - Get connectivity sessions
  • GET /v1/globalsim/sims/{iccid}/activity - Get activity events
  • GET /v1/globalsim/sims/activity - Get all SIM activity

Billing & Subscription​

  • GET /v1/globalsim/sims/billing - Get billing information
  • GET /v1/globalsim/subscription - Get subscription details

Device Integration​

  • GET /v1/globalsim/devices/{device_id}/sim - Get SIM for device
  • GET /v1/globalsim/devices/{device_id}/sim/billing - Get device SIM billing
  • GET /v1/globalsim/devices/{device_id}/sim/sessions - Get device SIM sessions
  • GET /v1/globalsim/devices/{device_id}/sim/activity - Get device SIM activity

Rate Limits​

  • 500 requests/minute per API key
  • Order limit: 1-100 SIM cards per order

Next Steps​

Support​

Need help?