List Modems

GET/api/v1/admin/proxy/modems

note

This endpoint requires Admin API Key authentication via the X-Admin-Key header.

Query Parameters

location_idstring

Filter by location UUID

statusstring

Filter by status: online, offline, error

carrierstring

Filter by carrier name

Response

modemsarray

Array of modem objects

Modem object

modem_idstring

UUID of the modem

imeistring

IMEI number of the modem

proxy_portinteger

HTTP proxy port (e.g., 3101)

carrierstring

Mobile carrier name

public_ipstring

Current public IP address

signal_strengthinteger

Signal strength (0-100%)

statusstring

Modem status: online, offline, error

is_healthyboolean

Whether modem is healthy and ready for traffic

requests_todayinteger

Number of proxy requests today

bytes_todayinteger

Bytes transferred today

rotations_todayinteger

Number of IP rotations today

last_rotation_atstring

ISO 8601 timestamp of last IP rotation

rotation_methodstring

Default rotation method: reconnect, airplane, ussd

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems" \
  -H "X-Admin-Key: your_admin_key"

import requests

response = requests.get(
    "https://spideriq.ai/api/v1/admin/proxy/modems",
    headers={"X-Admin-Key": "your_admin_key"}
)
for modem in response.json():
    print(f"Port {modem['proxy_port']}: {modem['carrier']} ({modem['signal_strength']}%)")

Response Example

[
  {
    "modem_id": "11111111-1111-1111-1111-111111111111",
    "imei": "123456789012345",
    "proxy_port": 3101,
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "iccid": null,
    "phone_number": null,
    "carrier": "lifecell",
    "public_ip": "203.0.113.50",
    "signal_strength": 100,
    "status": "online",
    "is_healthy": true,
    "requests_today": 0,
    "bytes_today": 0,
    "rotations_today": 0,
    "last_rotation_at": null,
    "rotation_method": "reconnect",
    "created_at": "2025-01-01T10:00:00.000000",
    "updated_at": "2025-01-15T12:30:00.000000"
  },
  {
    "modem_id": "22222222-2222-2222-2222-222222222222",
    "imei": "123456789012346",
    "proxy_port": 3102,
    "carrier": "lifecell",
    "public_ip": "203.0.113.51",
    "signal_strength": 100,
    "status": "online",
    "is_healthy": true
  }
]