---
title: "Run a new Ookla speedtest"
method: POST
path: "/api/v1/speedtests/run"
tags: ["Speedtests"]
---

# Run a new Ookla speedtest

`POST /api/v1/speedtests/run`

## Query parameters

- `server_id` integer

## Headers

- `Accept` string, required

## Response `201`

Created

- SpeedtestRun — A queued speedtest result
  - `data` object — Queued speedtest result payload
    - `id` integer
    - `service` string
    - `ping` number, float, nullable
    - `download` integer, nullable
    - `upload` integer, nullable
    - `benchmarks` object, nullable
    - `healthy` boolean, nullable
    - `status` string
    - `scheduled` boolean
    - `comments` string, nullable
    - `data` object — Additional data for queued result
      - `server` object
        - `id` integer, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `message` string — Response status message

## Other responses

- `401` — Unauthenticated
- `403` — Forbidden
- `406` — Not Acceptable - Missing or invalid Accept header
- `422` — Validation error

---

[API](https://skmtc.dev/speedtest-tracker/apis/speedtest-tracker-api.md) · [All operations](https://skmtc.dev/speedtest-tracker/apis/speedtest-tracker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/speedtest-tracker/speedtest-tracker-api/revisions/db5a45f72abb/schema)