Speedtests

Endpoints for running speedtests and listing servers.

Run a new Ookla speedtest

post

Query parameters

server_idintegerOptional

Optional Ookla speedtest server ID

Header parameters

AcceptstringRequired

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

Default: application/json

Responses

201

Created

application/json

A queued speedtest result

messagestringOptional

Response status message

401

Unauthenticated

application/json

403

Forbidden

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

422

Validation error

application/json

post/api/v1/speedtests/run

HTTPcURLJavaScriptPython

POST /api/v1/speedtests/run HTTP/1.1
Accept: application/json

{
  "data": {
    "id": 1,
    "service": "text",
    "ping": 1,
    "download": 1,
    "upload": 1,
    "benchmarks": {},
    "healthy": true,
    "status": "text",
    "scheduled": true,
    "comments": "text",
    "data": {
      "server": {
        "id": 1
      }
    },
    "created_at": "2026-07-20T15:35:13.829Z",
    "updated_at": "2026-07-20T15:35:13.829Z"
  },
  "message": "text"
}

List available Ookla speedtest servers

get

Header parameters

AcceptstringRequired

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

Default: application/json

Responses

200

OK

application/json

Collection of Ookla speedtest servers

messagestringOptional

Response status message

401

Unauthenticated

application/json

403

Forbidden

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

get/api/v1/speedtests/list-servers

HTTPcURLJavaScriptPython

GET /api/v1/speedtests/list-servers HTTP/1.1
Accept: application/json

{
  "data": [
    {
      "id": "text",
      "host": "text",
      "name": "text",
      "location": "text",
      "country": "text"
    }
  ],
  "message": "text"
}