๐Ÿ‡
Speedtest Tracker
  • Introduction
  • Features
  • Changelog
  • ๐Ÿš€Getting Started
    • Installation
      • Using Docker Compose
      • Using Docker
      • Using Kubernetes
      • Using QNAP
      • Using Synology
      • Using Unraid
    • Environment Variables
    • Database Drivers
  • ๐Ÿ†˜Help
    • Error Messages
    • Frequently Asked Questions
  • ๐Ÿ”‘Security
    • Authentication
    • Authorization
    • Encryption
  • โš™๏ธSettings
    • Data Integrations
      • InfluxDB v2
    • Notifications
      • Database
      • Mail
      • Webhook
  • ๐Ÿ‘€Other
    • Speedtest Process
    • Proxies
      • Cloudflare Tunnel (Zero Trust)
      • Traefik
      • Tailscale
    • Caching
    • Commands
    • Data Dictionary
    • Embed Dashboard
    • Health Check
    • Community Projects
  • ๐Ÿ–ฅ๏ธAPI
    • Authorization
    • Responses
      • Results
      • Speedtests
      • Servers
      • Stats
      • Models
  • ๐ŸคนContributing
    • Development Environment
  • ๐Ÿ”—More
    • Source Code
    • Releases
    • Update the Docs
    • About Me
    • Donate
Powered by GitBook
On this page
  1. API
  2. Responses

Results

PreviousResponsesNextSpeedtests

Operations related to Speedtest results. Requires an API token with scope results:read.

๐Ÿ–ฅ๏ธ

Fetch the single most recent result

get
Responses
200
OK
application/json
401
Unauthenticated
application/json
404
No result found
application/json
get
GET /api/v1/results/latest HTTP/1.1
Host: 
Accept: */*
{
  "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-06-14T09:14:21.639Z",
    "packetLoss": 1
  },
  "created_at": "2025-06-14T09:14:21.639Z",
  "updated_at": "2025-06-14T09:14:21.639Z"
}

List results

get
Responses
200
OK
application/json
401
Unauthenticated
application/json
422
Validation failed
application/json
get
GET /api/v1/results HTTP/1.1
Host: 
Accept: */*
{
  "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-06-14T09:14:21.639Z",
        "packetLoss": 1
      },
      "created_at": "2025-06-14T09:14:21.639Z",
      "updated_at": "2025-06-14T09:14:21.639Z"
    }
  ],
  "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
  }
}

Fetch a single result by ID

get
Path parameters
idintegerRequired

The ID of the result

Responses
200
OK
application/json
401
Unauthenticated
application/json
404
Result not found
application/json
get
GET /api/v1/results/{id} HTTP/1.1
Host: 
Accept: */*
{
  "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-06-14T09:14:21.639Z",
      "packetLoss": 1
    },
    "created_at": "2025-06-14T09:14:21.639Z",
    "updated_at": "2025-06-14T09:14:21.639Z"
  },
  "message": "text"
}
  • GETFetch the single most recent result
  • GETList results
  • GETFetch a single result by ID