Skip to main content

SIM Card Management

Complete guide to managing GlobalSIM cards across worldwide networks.

List SIM Cards​

Retrieve all your SIM cards with filtering by status.

Endpoint​

GET /v1/globalsim/sims

Query Parameters​

ParameterTypeDescriptionDefault
statusstringFilter by status: active, inactive, suspendedall
limitintegerMax results per page (1-100)50
offsetintegerPagination offset0

Request Example​

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

Response​

{
  "sims": [
    {
      "iccid": "8901234567890123456",
      "status": "active",
      "msisdn": "+4791234567",
      "imsi": "242011234567890",
      "current_network": {
        "country": "Norway",
        "country_code": "NO",
        "operator": "Telenor Norway",
        "network_code": "24201",
        "network_type": "4G"
      },
      "data_usage_mb": 125.4,
      "activated_at": "2025-10-15T10:00:00Z",
      "last_session": "2025-11-05T09:30:00Z"
    },
    {
      "iccid": "8901234567890234567",
      "status": "active",
      "msisdn": "+46701234567",
      "imsi": "240011234567890",
      "current_network": {
        "country": "Sweden",
        "country_code": "SE",
        "operator": "Telia Sweden",
        "network_code": "24001",
        "network_type": "5G"
      },
      "data_usage_mb": 456.8,
      "activated_at": "2025-09-20T14:00:00Z",
      "last_session": "2025-11-05T10:15:00Z"
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

Python Example​

import requests

API_KEY = 'YOUR_API_KEY'
API_URL = 'https://api.wayscloud.services/v1/globalsim'

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

    if status:
        params['status'] = status

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

    return response.json()

# List all active SIMs
active_sims = list_sims(status='active')

for sim in active_sims['sims']:
    print(f"{sim['iccid']}: {sim['msisdn']} - {sim['data_usage_mb']:.2f} MB used")

Get SIM Details​

Retrieve detailed information about a specific SIM card by ICCID.

Endpoint​

GET /v1/globalsim/sims/{iccid}

Request Example​

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

Response​

{
  "iccid": "8901234567890123456",
  "status": "active",
  "msisdn": "+4791234567",
  "imsi": "242011234567890",
  "current_network": {
    "country": "Norway",
    "country_code": "NO",
    "operator": "Telenor Norway",
    "network_code": "24201",
    "network_type": "4G",
    "signal_strength": -65,
    "connected_since": "2025-11-05T08:00:00Z"
  },
  "data_usage": {
    "current_month_mb": 125.4,
    "previous_month_mb": 98.7,
    "total_lifetime_mb": 2456.3
  },
  "device": {
    "device_id": "iot_dev_abc123",
    "device_name": "Temperature Sensor 01",
    "linked_at": "2025-10-15T10:00:00Z"
  },
  "activated_at": "2025-10-15T10:00:00Z",
  "last_session": "2025-11-05T09:30:00Z",
  "created_at": "2025-10-10T12:00:00Z"
}

Order SIM Cards​

Order new GlobalSIM cards for IoT connectivity.

Endpoint​

POST /v1/globalsim/sims/order

Request Body​

FieldTypeRequiredDescription
quantityintegerYesNumber of SIM cards (1-100)

Request Example​

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

Response​

{
  "order_id": "ord_abc123xyz",
  "quantity": 25,
  "status": "processing",
  "created_at": "2025-11-05T10:45:00Z"
}

Python Example​

def order_sims(quantity):
    headers = {
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }

    payload = {'quantity': quantity}

    response = requests.post(
        f'{API_URL}/sims/order',
        headers=headers,
        json=payload
    )

    return response.json()

# Order 10 SIM cards
order = order_sims(10)
print(f"Order ID: {order['order_id']}")
print(f"Status: {order['status']}")

List Available Networks​

Retrieve all 685+ available mobile networks worldwide.

Endpoint​

GET /v1/globalsim/sims/networks

Query Parameters​

ParameterTypeDescription
countrystringFilter by ISO 3166-1 alpha-2 country code
operatorstringSearch by operator name

Request Example​

# Get all networks in Norway
curl -X GET "https://api.wayscloud.services/v1/globalsim/sims/networks?country=NO" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response​

{
  "networks": [
    {
      "network_code": "24201",
      "country": "Norway",
      "country_code": "NO",
      "operator": "Telenor Norway",
      "network_types": ["2G", "3G", "4G", "5G"]
    },
    {
      "network_code": "24202",
      "country": "Norway",
      "country_code": "NO",
      "operator": "Telia Norway",
      "network_types": ["2G", "3G", "4G", "5G"]
    },
    {
      "network_code": "24208",
      "country": "Norway",
      "country_code": "NO",
      "operator": "Ice Norway",
      "network_types": ["3G", "4G", "5G"]
    }
  ],
  "total": 3
}

Search Networks by Operator​

# Find all Telenor networks
curl -X GET "https://api.wayscloud.services/v1/globalsim/sims/networks?operator=Telenor" \
  -H "Authorization: Bearer YOUR_API_KEY"

Node.js Example​

async function getNetworks(country = null, operator = null) {
  const params = new URLSearchParams();

  if (country) params.append('country', country);
  if (operator) params.append('operator', operator);

  const response = await axios.get(
    `${API_URL}/sims/networks?${params.toString()}`,
    {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    }
  );

  return response.data;
}

// Get all Nordic networks
const nordicCountries = ['NO', 'SE', 'DK', 'FI', 'IS'];
for (const country of nordicCountries) {
  const networks = await getNetworks(country);
  console.log(`${country}: ${networks.total} networks`);
}

SIM Status​

SIM cards can have the following statuses:

  • active - SIM is active and can connect to networks
  • inactive - SIM has not been activated yet
  • suspended - SIM is temporarily suspended
  • expired - SIM has expired and needs renewal
  • cancelled - SIM has been permanently cancelled

Network Types​

GlobalSIM supports multiple network generations:

  • 2G - Basic connectivity
  • 3G - Standard mobile data
  • 4G/LTE - High-speed mobile data
  • 5G - Next-generation ultra-fast connectivity

Next Steps​