Results

Endpoints for accessing and filtering speedtest results. Requires API token with results:read scope.

List all results

get

Query parameters

per.pageinteger · min: 1 · max: 500Optional

Number of results per page

Default: 25

filter[ping]numberOptional

Filter by ping value (supports operators like >=, <=, etc.)

filter[download]integerOptional

Filter by download speed (supports operators like >=, <=, etc.)

filter[upload]integerOptional

Filter by upload speed (supports operators like >=, <=, etc.)

filter[healthy]booleanOptional

Filter by healthy status

filter[status]stringOptional

Filter by status

filter[scheduled]booleanOptional

Filter by scheduled status

filter[start_at]string · dateOptional

Filter results created on or after this date (alias for created_at>=)

filter[end_at]string · dateOptional

Filter results created on or before this date (alias for created_at<=)

sortstring · enumOptional

Sort results by field (prefix with - for descending)

Possible values:

Header parameters

AcceptstringRequired

Must be "application/json" - this API only accepts and returns JSON

Default: application/json

Responses

200

OK

application/json

401

Unauthenticated

application/json

403

Forbidden

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

422

Validation failed

application/json

get

/api/v1/results

HTTPcURLJavaScriptPython

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-12-13T20:04:08.609Z",
        "packetLoss": 1
      },
      "created_at": "2025-12-13T20:04:08.609Z",
      "updated_at": "2025-12-13T20:04:08.609Z"
    }
  ],
  "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
  }
}

Get a single result

get

Path parameters

idintegerRequired

The ID of the result

Header parameters

AcceptstringRequired

Must be "application/json" - this API only accepts and returns JSON

Default: application/json

Responses

200

OK

application/json

401

Unauthenticated

application/json

403

Forbidden

application/json

404

Result not found

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

get

/api/v1/results/{id}

HTTPcURLJavaScriptPython

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-12-13T20:04:08.609Z",
      "packetLoss": 1
    },
    "created_at": "2025-12-13T20:04:08.609Z",
    "updated_at": "2025-12-13T20:04:08.609Z"
  },
  "message": "text"
}

Get the most recent result

get

Header parameters

AcceptstringRequired

Must be "application/json" - this API only accepts and returns JSON

Default: application/json

Responses

200

OK

application/json

401

Unauthenticated

application/json

403

Forbidden

application/json

404

No result found

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

get

/api/v1/results/latest

HTTPcURLJavaScriptPython

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-12-13T20:04:08.609Z",
    "packetLoss": 1
  },
  "created_at": "2025-12-13T20:04:08.609Z",
  "updated_at": "2025-12-13T20:04:08.609Z"
}