GET
https://spideriq.ai
/
api
/
v1
/
admin
/
proxy
/
speed-tests
/
summary
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/speed-tests/summary?days=30" \
  -H "X-Admin-Key: your_admin_key"

{
  "period_days": 30,
  "modem_count": 4,
  "modems": [
    {
      "modem_id": "11111111-1111-1111-1111-111111111111",
      "carrier": "lifecell",
      "last_download_mbps": 45.23,
      "last_upload_mbps": 12.87,
      "last_latency_ms": 42,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 44.5,
      "avg_upload_mbps": 12.3,
      "avg_latency_ms": 43,
      "min_download_mbps": 35.2,
      "max_download_mbps": 52.1
    },
    {
      "modem_id": "22222222-2222-2222-2222-222222222222",
      "carrier": "MTS UKR",
      "last_download_mbps": 38.45,
      "last_upload_mbps": 10.23,
      "last_latency_ms": 55,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 37.8,
      "avg_upload_mbps": 9.8,
      "avg_latency_ms": 58,
      "min_download_mbps": 28.5,
      "max_download_mbps": 45.2
    }
  ]
}
This endpoint requires Admin API Key authentication via the X-Admin-Key header.
Returns aggregated speed test statistics for all modems, useful for comparing carrier performance.

​
Query Parameters

​
location_id
string
Filter by location UUID
​
days
integer
default:"30"
Number of days to analyze (1-365)

​
Response

​
period_days
integer
required
Number of days analyzed
​
modem_count
integer
required
Number of modems included
​
modems
array
required
Array of modem summaries with averages
Each modem summary contains:
  • modem_id: Modem UUID
  • carrier: Carrier name (e.g., “lifecell”)
  • last_download_mbps: Most recent download speed
  • last_upload_mbps: Most recent upload speed
  • last_latency_ms: Most recent latency
  • last_speed_test_at: Timestamp of last test
  • test_count: Number of tests in period
  • avg_download_mbps: Average download speed
  • avg_upload_mbps: Average upload speed
  • avg_latency_ms: Average latency
  • min_download_mbps: Minimum download speed
  • max_download_mbps: Maximum download speed
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/speed-tests/summary?days=30" \
  -H "X-Admin-Key: your_admin_key"

{
  "period_days": 30,
  "modem_count": 4,
  "modems": [
    {
      "modem_id": "11111111-1111-1111-1111-111111111111",
      "carrier": "lifecell",
      "last_download_mbps": 45.23,
      "last_upload_mbps": 12.87,
      "last_latency_ms": 42,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 44.5,
      "avg_upload_mbps": 12.3,
      "avg_latency_ms": 43,
      "min_download_mbps": 35.2,
      "max_download_mbps": 52.1
    },
    {
      "modem_id": "22222222-2222-2222-2222-222222222222",
      "carrier": "MTS UKR",
      "last_download_mbps": 38.45,
      "last_upload_mbps": 10.23,
      "last_latency_ms": 55,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 37.8,
      "avg_upload_mbps": 9.8,
      "avg_latency_ms": 58,
      "min_download_mbps": 28.5,
      "max_download_mbps": 45.2
    }
  ]
}

​
Use Cases

  1. Carrier Comparison: Identify which carriers provide best performance
  2. Performance Monitoring: Track speed degradation over time
  3. Capacity Planning: Understand bandwidth availability per modem
  4. SLA Verification: Ensure carriers meet expected speeds