Skip to main content
GET
/
consumer
/
speedtest
/
config
Get speed test configuration
curl --request GET \
  --url https://api.hixbe.com/fiber/consumer/speedtest/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Hixe-Version: <hixe-version>'
{
  "server": "speedtest-ny.hixbe.com",
  "latency_endpoint": "https://speedtest-ny.hixbe.com/latency",
  "download_endpoint": "https://speedtest-ny.hixbe.com/download",
  "upload_endpoint": "https://speedtest-ny.hixbe.com/upload",
  "recommended_duration_seconds": 10
}
Returns configuration for running speed tests against Hixbe’s nearest server. The server selection is automatic based on the customer’s location. Use Cases:
  • Implement custom speed test tools
  • Verify connection performance
  • Troubleshoot bandwidth issues
Implementation Notes:
  • Use the latency endpoint for ping tests (typically 10 requests)
  • Download/upload tests should run for at least 10 seconds for accuracy
  • Tests should be performed during off-peak hours for best results

Authorizations

​
Authorization
string
header
required

JWT token obtained from Hixbe account dashboard

Headers

​
Hixe-Version
string
required

API version in YYYY-MM-DD format. Current version: 2026-01-01

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-01"

Response

Successfully retrieved speed test configuration

Configuration for running speed tests against Hixbe servers

​
server
string
required

Primary speed test server hostname

Example:

"speedtest-ny.hixbe.com"

​
latency_endpoint
string
required

Endpoint for latency/ping tests

Example:

"https://speedtest-ny.hixbe.com/latency"

​
download_endpoint
string
required

Endpoint for download speed tests

Example:

"https://speedtest-ny.hixbe.com/download"

​
upload_endpoint
string
required

Endpoint for upload speed tests

Example:

"https://speedtest-ny.hixbe.com/upload"

​
recommended_duration_seconds
integer
default:10

Recommended test duration for accurate results

Example:

10