GET
https://spideriq.ai
/
api
/
v1
/
admin
/
proxy
/
modems
/
{modem_id}
/
speed-tests
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/speed-tests?days=7" \
  -H "X-Admin-Key: your_admin_key"
{
  "modem_id": "11111111-1111-1111-1111-111111111111",
  "test_count": 7,
  "tests": [
    {
      "id": 42,
      "download_mbps": 45.23,
      "upload_mbps": 12.87,
      "latency_ms": 42,
      "jitter_ms": 5,
      "test_server": "speedtest.kyivstar.ua",
      "success": true,
      "created_at": "2026-01-05T03:00:00Z"
    },
    {
      "id": 41,
      "download_mbps": 43.12,
      "upload_mbps": 11.45,
      "latency_ms": 45,
      "jitter_ms": 7,
      "test_server": "speedtest.kyivstar.ua",
      "success": true,
      "created_at": "2026-01-04T03:00:00Z"
    }
  ]
}
This endpoint requires Admin API Key authentication via the X-Admin-Key header.
Returns speed test history for a specific modem, useful for tracking carrier performance over time.

Path Parameters

modem_id
string
required
UUID of the modem

Query Parameters

days
integer
default:"30"
Number of days of history (1-365)
limit
integer
default:"100"
Maximum number of results (1-500)

Response

modem_id
string
required
UUID of the modem
test_count
integer
required
Number of tests returned
tests
array
required
Array of speed test results
Each test object contains:
  • id: Test ID
  • download_mbps: Download speed in Mbps
  • upload_mbps: Upload speed in Mbps
  • latency_ms: Latency in milliseconds
  • jitter_ms: Jitter in milliseconds
  • test_server: Server used for test
  • success: Whether test completed successfully
  • created_at: ISO timestamp
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/speed-tests?days=7" \
  -H "X-Admin-Key: your_admin_key"
{
  "modem_id": "11111111-1111-1111-1111-111111111111",
  "test_count": 7,
  "tests": [
    {
      "id": 42,
      "download_mbps": 45.23,
      "upload_mbps": 12.87,
      "latency_ms": 42,
      "jitter_ms": 5,
      "test_server": "speedtest.kyivstar.ua",
      "success": true,
      "created_at": "2026-01-05T03:00:00Z"
    },
    {
      "id": 41,
      "download_mbps": 43.12,
      "upload_mbps": 11.45,
      "latency_ms": 45,
      "jitter_ms": 7,
      "test_server": "speedtest.kyivstar.ua",
      "success": true,
      "created_at": "2026-01-04T03:00:00Z"
    }
  ]
}