Get Statistics

Returns aggregate statistics for test results within a time range.

Statistics Provided:

• Average, min, max for each metric
• Percentiles (P95, P99)
• Total test count
• Time range analyzed

Use Cases:

• Performance monitoring
• SLA tracking
• Trend analysis
• Network health dashboards
• Historical comparison

Time Range: Defaults to last 60 minutes, configurable up to 30 days.

GET /stats

Get Speed Statistics

cURL

curl --request GET \
  --url https://api.hixbe.com/speedtest/stats \
  --header 'Hixbe-Version: <hixbe-version>'

400

{
  "success": false,
  "timestamp": "2025-12-07T10:30:00.000Z",
  "error": {
    "code": "no_data",
    "message": "No results found in the last 60 minutes",
    "type": "ValidationError"
  }
}

Retrieve aggregate statistics including min, max, average speeds and trends over time.

Headers

Hixbe-Version · string · required

API version header. Required for all endpoints except / and /health

Pattern: ^\d+\.\d+\.\d+$

Example:

"2.0.0"

Query Parameters

timeRange · integer · default: 60

Time range for statistics in minutes

Required range: 1 <= x <= 43200

Response

200

application/json

Statistics retrieved successfully