Skip to main content

Speed Test History

GET/api/v1/admin/proxy/modems/{modem_id}/speed-tests
note

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_idstringrequired

UUID of the modem

Query Parameters​

daysintegerdefault: 30

Number of days of history (1-365)

limitintegerdefault: 100

Maximum number of results (1-500)

Response​

modem_idstring

UUID of the modem

test_countinteger

Number of tests returned

testsarray

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

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/speed-tests?days=7" \
  -H "X-Admin-Key: your_admin_key"
import requests

modem_id = "11111111-1111-1111-1111-111111111111"
response = requests.get(
    f"https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/speed-tests",
    params={"days": 7},
    headers={"X-Admin-Key": "your_admin_key"}
)
print(response.json())

Response Example

{
  "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"
    }
  ]
}