Results
Endpoints for accessing and filtering speedtest results. Requires API token with results:read
scope.
Number of results per page
25
Filter by ping value (supports operators like >=, <=, etc.)
Filter by download speed (supports operators like >=, <=, etc.)
Filter by upload speed (supports operators like >=, <=, etc.)
Filter by healthy status
Filter by status
Filter by scheduled status
Filter results created on or after this date (alias for created_at>=)
Filter results created on or before this date (alias for created_at<=)
Sort results by field (prefix with - for descending)
Must be "application/json" - this API only accepts and returns JSON
application/json
OK
Unauthenticated
Forbidden
Not Acceptable - Missing or invalid Accept header
Validation failed
GET /api/v1/results HTTP/1.1
Host:
Accept: application/json
{
"data": [
{
"id": 1,
"service": "text",
"ping": 1,
"download": 1,
"upload": 1,
"download_bits": 1,
"upload_bits": 1,
"download_bits_human": "text",
"upload_bits_human": "text",
"benchmarks": [
{}
],
"healthy": true,
"status": "text",
"scheduled": true,
"comments": "text",
"data": {
"isp": "text",
"ping": {
"low": 1,
"high": 1,
"jitter": 1,
"latency": 1
},
"type": "text",
"result": {
"id": "text",
"url": "https://example.com",
"persisted": true
},
"server": {
"id": 1,
"ip": "0.0.0.0",
"host": "text",
"name": "text",
"port": 1,
"country": "text",
"location": "text"
},
"upload": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"download": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"interface": {
"name": "text",
"isVpn": true,
"macAddr": "text",
"externalIp": "0.0.0.0",
"internalIp": "0.0.0.0"
},
"timestamp": "2025-10-05T13:48:45.659Z",
"packetLoss": 1
},
"created_at": "2025-10-05T13:48:45.659Z",
"updated_at": "2025-10-05T13:48:45.659Z"
}
],
"links": {
"first": "text",
"last": "text",
"prev": "text",
"next": "text"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": "text",
"label": "text",
"active": true
}
],
"path": "text",
"per_page": 1,
"to": 1,
"total": 1
}
}
The ID of the result
Must be "application/json" - this API only accepts and returns JSON
application/json
OK
Unauthenticated
Forbidden
Result not found
Not Acceptable - Missing or invalid Accept header
GET /api/v1/results/{id} HTTP/1.1
Host:
Accept: application/json
{
"data": {
"id": 1,
"service": "text",
"ping": 1,
"download": 1,
"upload": 1,
"download_bits": 1,
"upload_bits": 1,
"download_bits_human": "text",
"upload_bits_human": "text",
"benchmarks": [
{}
],
"healthy": true,
"status": "text",
"scheduled": true,
"comments": "text",
"data": {
"isp": "text",
"ping": {
"low": 1,
"high": 1,
"jitter": 1,
"latency": 1
},
"type": "text",
"result": {
"id": "text",
"url": "https://example.com",
"persisted": true
},
"server": {
"id": 1,
"ip": "0.0.0.0",
"host": "text",
"name": "text",
"port": 1,
"country": "text",
"location": "text"
},
"upload": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"download": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"interface": {
"name": "text",
"isVpn": true,
"macAddr": "text",
"externalIp": "0.0.0.0",
"internalIp": "0.0.0.0"
},
"timestamp": "2025-10-05T13:48:45.659Z",
"packetLoss": 1
},
"created_at": "2025-10-05T13:48:45.659Z",
"updated_at": "2025-10-05T13:48:45.659Z"
},
"message": "text"
}
Must be "application/json" - this API only accepts and returns JSON
application/json
OK
Unauthenticated
Forbidden
No result found
Not Acceptable - Missing or invalid Accept header
GET /api/v1/results/latest HTTP/1.1
Host:
Accept: application/json
{
"id": 1,
"service": "text",
"ping": 1,
"download": 1,
"upload": 1,
"download_bits": 1,
"upload_bits": 1,
"download_bits_human": "text",
"upload_bits_human": "text",
"benchmarks": [
{}
],
"healthy": true,
"status": "text",
"scheduled": true,
"comments": "text",
"data": {
"isp": "text",
"ping": {
"low": 1,
"high": 1,
"jitter": 1,
"latency": 1
},
"type": "text",
"result": {
"id": "text",
"url": "https://example.com",
"persisted": true
},
"server": {
"id": 1,
"ip": "0.0.0.0",
"host": "text",
"name": "text",
"port": 1,
"country": "text",
"location": "text"
},
"upload": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"download": {
"bytes": 1,
"elapsed": 1,
"latency": {
"iqm": 1,
"low": 1,
"high": 1,
"jitter": 1
},
"bandwidth": 1
},
"interface": {
"name": "text",
"isVpn": true,
"macAddr": "text",
"externalIp": "0.0.0.0",
"internalIp": "0.0.0.0"
},
"timestamp": "2025-10-05T13:48:45.659Z",
"packetLoss": 1
},
"created_at": "2025-10-05T13:48:45.659Z",
"updated_at": "2025-10-05T13:48:45.659Z"
}