diff --git a/app/Http/Controllers/Api/V1/ApiController.php b/app/Http/Controllers/Api/V1/ApiController.php
index 132798dfb..28c09badf 100644
--- a/app/Http/Controllers/Api/V1/ApiController.php
+++ b/app/Http/Controllers/Api/V1/ApiController.php
@@ -4,9 +4,7 @@
 
 use Illuminate\Http\Exceptions\HttpResponseException;
 use Illuminate\Support\Facades\Log;
-use OpenApi\Attributes as OA;
 
-#[OA\Info(title: 'Speedtest Tracker API', version: '1.0.0')]
 abstract class ApiController
 {
     /**
diff --git a/app/Http/Controllers/Api/V1/LatestResult.php b/app/Http/Controllers/Api/V1/LatestResult.php
index 55d1281a6..1309c105e 100644
--- a/app/Http/Controllers/Api/V1/LatestResult.php
+++ b/app/Http/Controllers/Api/V1/LatestResult.php
@@ -13,11 +13,27 @@ class LatestResult extends ApiController
 {
     #[OA\Get(
         path: '/api/v1/results/latest',
-        description: 'Get the latest result.',
+        summary: 'Fetch the single most recent result',
+        operationId: 'getLatestResult',
+        tags: ['Results'],
         responses: [
-            new OA\Response(response: 200, description: 'OK'),
-            new OA\Response(response: Response::HTTP_NOT_FOUND, description: 'No result found'),
-        ])]
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'OK',
+                content: new OA\JsonContent(ref: '#/components/schemas/Result')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_NOT_FOUND,
+                description: 'No result found',
+                content: new OA\JsonContent(ref: '#/components/schemas/NotFoundError')
+            ),
+        ]
+    )]
     public function __invoke(Request $request)
     {
         $result = Result::query()
diff --git a/app/Http/Controllers/Api/V1/ListResults.php b/app/Http/Controllers/Api/V1/ListResults.php
index d0789df8a..d634496c1 100644
--- a/app/Http/Controllers/Api/V1/ListResults.php
+++ b/app/Http/Controllers/Api/V1/ListResults.php
@@ -16,11 +16,29 @@ class ListResults extends ApiController
 {
     #[OA\Get(
         path: '/api/v1/results',
-        description: 'List results.',
+        summary: 'List results',
+        operationId: 'listResults',
+        tags: ['Results'],
         responses: [
-            new OA\Response(response: Response::HTTP_OK, description: 'OK'),
-            new OA\Response(response: Response::HTTP_UNPROCESSABLE_ENTITY, description: 'Unprocessable Entity'),
-        ])]
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'OK',
+                content: new OA\JsonContent(
+                    ref: '#/components/schemas/ResultsCollection'
+                )
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNPROCESSABLE_ENTITY,
+                description: 'Validation failed',
+                content: new OA\JsonContent(ref: '#/components/schemas/ValidationError')
+            ),
+        ]
+    )]
     public function __invoke(Request $request)
     {
         $validator = Validator::make($request->all(), [
diff --git a/app/Http/Controllers/Api/V1/ListSpeedtestServers.php b/app/Http/Controllers/Api/V1/ListSpeedtestServers.php
index 12b9839aa..c67efa648 100644
--- a/app/Http/Controllers/Api/V1/ListSpeedtestServers.php
+++ b/app/Http/Controllers/Api/V1/ListSpeedtestServers.php
@@ -11,10 +11,30 @@ class ListSpeedtestServers extends ApiController
 {
     #[OA\Get(
         path: '/api/v1/ookla/list-servers',
-        description: 'Get a list of available Ookla speedtest servers.',
+        summary: 'List available Ookla speedtest servers',
+        operationId: 'listSpeedtestServers',
+        tags: ['Servers'],
         responses: [
-            new OA\Response(response: Response::HTTP_OK, description: 'OK'),
-            new OA\Response(response: Response::HTTP_FORBIDDEN, description: 'Forbidden'),
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'OK',
+                content: new OA\JsonContent(
+                    ref: '#/components/schemas/ServersCollection'
+                )
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_FORBIDDEN,
+                description: 'Forbidden',
+                content: new OA\JsonContent(
+                    ref: '#/components/schemas/ForbiddenError',
+                    example: ['message' => 'You do not have permission to view speedtest servers.']
+                )
+            ),
         ]
     )]
     public function __invoke(Request $request)
diff --git a/app/Http/Controllers/Api/V1/RunSpeedtest.php b/app/Http/Controllers/Api/V1/RunSpeedtest.php
index ae4588e0d..cf219bf0b 100644
--- a/app/Http/Controllers/Api/V1/RunSpeedtest.php
+++ b/app/Http/Controllers/Api/V1/RunSpeedtest.php
@@ -13,20 +13,39 @@ class RunSpeedtest extends ApiController
 {
     #[OA\Post(
         path: '/api/v1/speedtests/run',
-        description: 'Run a new Ookla speedtest. Optionally provide a server_id.',
+        summary: 'Run a new Ookla speedtest',
+        operationId: 'runSpeedtest',
+        tags: ['Speedtests'],
         parameters: [
             new OA\Parameter(
                 name: 'server_id',
                 in: 'query',
+                description: 'Optional Ookla speedtest server ID',
                 required: false,
-                schema: new OA\Schema(type: 'integer'),
-                description: 'Optional Ookla speedtest server ID'
+                schema: new OA\Schema(type: 'integer')
             ),
         ],
         responses: [
-            new OA\Response(response: Response::HTTP_CREATED, description: 'Created'),
-            new OA\Response(response: Response::HTTP_FORBIDDEN, description: 'Forbidden'),
-            new OA\Response(response: Response::HTTP_UNPROCESSABLE_ENTITY, description: 'Validation error'),
+            new OA\Response(
+                response: Response::HTTP_CREATED,
+                description: 'Created',
+                content: new OA\JsonContent(ref: '#/components/schemas/SpeedtestRun')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_FORBIDDEN,
+                description: 'Forbidden',
+                content: new OA\JsonContent(ref: '#/components/schemas/ForbiddenError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNPROCESSABLE_ENTITY,
+                description: 'Validation error',
+                content: new OA\JsonContent(ref: '#/components/schemas/ValidationError')
+            ),
         ]
     )]
     public function __invoke(Request $request)
diff --git a/app/Http/Controllers/Api/V1/ShowResult.php b/app/Http/Controllers/Api/V1/ShowResult.php
index 4b5f42998..d30a8452c 100644
--- a/app/Http/Controllers/Api/V1/ShowResult.php
+++ b/app/Http/Controllers/Api/V1/ShowResult.php
@@ -13,11 +13,36 @@ class ShowResult extends ApiController
 {
     #[OA\Get(
         path: '/api/v1/results/{id}',
-        description: 'Get result.',
+        summary: 'Fetch a single result by ID',
+        operationId: 'getResult',
+        tags: ['Results'],
+        parameters: [
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The ID of the result'
+            ),
+        ],
         responses: [
-            new OA\Response(response: 200, description: 'OK'),
-            new OA\Response(response: Response::HTTP_NOT_FOUND, description: 'Result not found'),
-        ])]
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'OK',
+                content: new OA\JsonContent(ref: '#/components/schemas/ResultResponse')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_NOT_FOUND,
+                description: 'Result not found',
+                content: new OA\JsonContent(ref: '#/components/schemas/NotFoundError')
+            ),
+        ]
+    )]
     public function __invoke(Request $request, int $id)
     {
         $result = Result::findOr($id, function () {
diff --git a/app/Http/Controllers/Api/V1/Stats.php b/app/Http/Controllers/Api/V1/Stats.php
index dcf3691e3..fead80892 100644
--- a/app/Http/Controllers/Api/V1/Stats.php
+++ b/app/Http/Controllers/Api/V1/Stats.php
@@ -5,6 +5,9 @@
 use App\Http\Resources\V1\StatResource;
 use App\Models\Result;
 use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use OpenApi\Attributes as OA;
+use OpenApi\Attributes\Schema as OASchema;
 use Spatie\QueryBuilder\AllowedFilter;
 use Spatie\QueryBuilder\Enums\FilterOperator;
 use Spatie\QueryBuilder\QueryBuilder;
@@ -14,6 +17,45 @@ class Stats extends ApiController
     /**
      * Handle the incoming request.
      */
+    #[OA\Get(
+        path: '/api/v1/stats',
+        summary: 'Fetch aggregated Speedtest statistics',
+        operationId: 'getStats',
+        tags: ['Stats'],
+        parameters: [
+            new OA\Parameter(
+                name: 'start_at',
+                in: 'query',
+                description: 'ISO‑8601 start datetime filter',
+                required: false,
+                schema: new OASchema(type: 'string', format: 'date-time')
+            ),
+            new OA\Parameter(
+                name: 'end_at',
+                in: 'query',
+                description: 'ISO‑8601 end datetime filter',
+                required: false,
+                schema: new OASchema(type: 'string', format: 'date-time')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'OK',
+                content: new OA\JsonContent(ref: '#/components/schemas/Stats')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNAUTHORIZED,
+                description: 'Unauthenticated',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthenticatedError')
+            ),
+            new OA\Response(
+                response: Response::HTTP_UNPROCESSABLE_ENTITY,
+                description: 'Validation failed',
+                content: new OA\JsonContent(ref: '#/components/schemas/ValidationError')
+            ),
+        ]
+    )]
     public function __invoke(Request $request)
     {
         $stats = QueryBuilder::for(Result::class)
diff --git a/app/OpenApi/OpenApiDefinition.php b/app/OpenApi/OpenApiDefinition.php
new file mode 100644
index 000000000..6b8276680
--- /dev/null
+++ b/app/OpenApi/OpenApiDefinition.php
@@ -0,0 +1,38 @@
+<?php
+
+namespace App\OpenApi;
+
+use OpenApi\Attributes as OA;
+
+#[OA\OpenApi(
+    info: new OA\Info(
+        title: 'Speedtest Tracker API',
+        version: '1.0.0',
+    ),
+    components: new OA\Components(
+        securitySchemes: [
+            new OA\SecurityScheme(
+                securityScheme: 'bearerAuth',
+                type: 'http',
+                scheme: 'bearer',
+                bearerFormat: 'JWT'
+            ),
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'Accept',
+                in: 'header',
+                required: true,
+                schema: new OA\Schema(type: 'string', default: 'application/json'),
+                description: 'Expected response format'
+            ),
+        ]
+    ),
+    tags: [
+        new OA\Tag(name: 'Results', description: "Operations related to Speedtest results.\nRequires an API token with scope `results:read`."),
+        new OA\Tag(name: 'Speedtests', description: "Operations to run speedtests.\nRequires an API token with scope `speedtests:run`."),
+        new OA\Tag(name: 'Servers', description: "Operations for speedtest servers.\nRequires an API token with scope `ookla:list-servers`."),
+        new OA\Tag(name: 'Stats', description: "Operations for statistics.\nRequires an API token with scope `results:read`."),
+    ]
+)]
+class OpenApiDefinition {}
diff --git a/app/OpenApi/Schemas/ForbiddenErrorSchema.php b/app/OpenApi/Schemas/ForbiddenErrorSchema.php
new file mode 100644
index 000000000..8ea689fb7
--- /dev/null
+++ b/app/OpenApi/Schemas/ForbiddenErrorSchema.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'ForbiddenError',
+    type: 'object',
+    description: 'Forbidden error response when user lacks permission',
+    properties: [
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Error message indicating lack of permission',
+        ),
+    ]
+)]
+class ForbiddenErrorSchema {}
diff --git a/app/OpenApi/Schemas/NotFoundErrorSchema.php b/app/OpenApi/Schemas/NotFoundErrorSchema.php
new file mode 100644
index 000000000..b8ff7321a
--- /dev/null
+++ b/app/OpenApi/Schemas/NotFoundErrorSchema.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'NotFoundError',
+    type: 'object',
+    description: 'Error when a requested result is not found',
+    properties: [
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Result not found error message',
+        ),
+    ],
+)]
+class NotFoundErrorSchema {}
diff --git a/app/OpenApi/Schemas/ResultResponseSchema.php b/app/OpenApi/Schemas/ResultResponseSchema.php
new file mode 100644
index 000000000..952f73279
--- /dev/null
+++ b/app/OpenApi/Schemas/ResultResponseSchema.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'ResultResponse',
+    type: 'object',
+    description: 'Response for an Single Speedtest result entry',
+    properties: [
+        new OA\Property(
+            property: 'data',
+            ref: '#/components/schemas/Result'
+        ),
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Response status message',
+        ),
+    ]
+)]
+class ResultResponseSchema {}
diff --git a/app/OpenApi/Schemas/ResultSchema.php b/app/OpenApi/Schemas/ResultSchema.php
new file mode 100644
index 000000000..c35089b94
--- /dev/null
+++ b/app/OpenApi/Schemas/ResultSchema.php
@@ -0,0 +1,123 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'Result',
+    type: 'object',
+    description: 'Speedtest result entry',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer'),
+        new OA\Property(property: 'service', type: 'string'),
+        new OA\Property(property: 'ping', type: 'number'),
+        new OA\Property(property: 'download', type: 'integer'),
+        new OA\Property(property: 'upload', type: 'integer'),
+        new OA\Property(property: 'download_bits', type: 'integer'),
+        new OA\Property(property: 'upload_bits', type: 'integer'),
+        new OA\Property(property: 'download_bits_human', type: 'string'),
+        new OA\Property(property: 'upload_bits_human', type: 'string'),
+        new OA\Property(property: 'benchmarks', type: 'array', nullable: true, items: new OA\Items(type: 'object')),
+        new OA\Property(property: 'healthy', type: 'boolean', nullable: true),
+        new OA\Property(property: 'status', type: 'string'),
+        new OA\Property(property: 'scheduled', type: 'boolean'),
+        new OA\Property(property: 'comments', type: 'string', nullable: true),
+        new OA\Property(
+            property: 'data',
+            type: 'object',
+            description: 'Nested speedtest data payload',
+            properties: [
+                new OA\Property(property: 'isp', type: 'string'),
+                new OA\Property(
+                    property: 'ping',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'low', type: 'number', format: 'float'),
+                        new OA\Property(property: 'high', type: 'number', format: 'float'),
+                        new OA\Property(property: 'jitter', type: 'number', format: 'float'),
+                        new OA\Property(property: 'latency', type: 'number', format: 'float'),
+                    ]
+                ),
+                new OA\Property(property: 'type', type: 'string'),
+                new OA\Property(
+                    property: 'result',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'id', type: 'string'),
+                        new OA\Property(property: 'url', type: 'string', format: 'uri'),
+                        new OA\Property(property: 'persisted', type: 'boolean'),
+                    ]
+                ),
+                new OA\Property(
+                    property: 'server',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'id', type: 'integer'),
+                        new OA\Property(property: 'ip', type: 'string', format: 'ipv4'),
+                        new OA\Property(property: 'host', type: 'string'),
+                        new OA\Property(property: 'name', type: 'string'),
+                        new OA\Property(property: 'port', type: 'integer'),
+                        new OA\Property(property: 'country', type: 'string'),
+                        new OA\Property(property: 'location', type: 'string'),
+                    ]
+                ),
+                new OA\Property(
+                    property: 'upload',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'bytes', type: 'integer'),
+                        new OA\Property(property: 'elapsed', type: 'integer'),
+                        new OA\Property(
+                            property: 'latency',
+                            type: 'object',
+                            properties: [
+                                new OA\Property(property: 'iqm', type: 'number', format: 'float'),
+                                new OA\Property(property: 'low', type: 'number', format: 'float'),
+                                new OA\Property(property: 'high', type: 'number', format: 'float'),
+                                new OA\Property(property: 'jitter', type: 'number', format: 'float'),
+                            ]
+                        ),
+                        new OA\Property(property: 'bandwidth', type: 'integer'),
+                    ]
+                ),
+                new OA\Property(
+                    property: 'download',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'bytes', type: 'integer'),
+                        new OA\Property(property: 'elapsed', type: 'integer'),
+                        new OA\Property(
+                            property: 'latency',
+                            type: 'object',
+                            properties: [
+                                new OA\Property(property: 'iqm', type: 'number', format: 'float'),
+                                new OA\Property(property: 'low', type: 'number', format: 'float'),
+                                new OA\Property(property: 'high', type: 'number', format: 'float'),
+                                new OA\Property(property: 'jitter', type: 'number', format: 'float'),
+                            ]
+                        ),
+                        new OA\Property(property: 'bandwidth', type: 'integer'),
+                    ]
+                ),
+                new OA\Property(
+                    property: 'interface',
+                    type: 'object',
+                    properties: [
+                        new OA\Property(property: 'name', type: 'string'),
+                        new OA\Property(property: 'isVpn', type: 'boolean'),
+                        new OA\Property(property: 'macAddr', type: 'string', pattern: '^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$'),
+                        new OA\Property(property: 'externalIp', type: 'string', format: 'ipv4'),
+                        new OA\Property(property: 'internalIp', type: 'string', format: 'ipv4'),
+                    ]
+                ),
+                new OA\Property(property: 'timestamp', type: 'string', format: 'date-time'),
+                new OA\Property(property: 'packetLoss', type: 'number'),
+            ]
+        ),
+        new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
+        new OA\Property(property: 'updated_at', type: 'string', format: 'date-time'),
+    ],
+    additionalProperties: false
+)]
+class ResultSchema {}
diff --git a/app/OpenApi/Schemas/ResultsCollectionSchema.php b/app/OpenApi/Schemas/ResultsCollectionSchema.php
new file mode 100644
index 000000000..2a4ac55a7
--- /dev/null
+++ b/app/OpenApi/Schemas/ResultsCollectionSchema.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'ResultsCollection',
+    type: 'object',
+    description: 'Paginated list of Speedtest results',
+    properties: [
+        new OA\Property(
+            property: 'data',
+            type: 'array',
+            description: 'Array of result objects',
+            items: new OA\Items(ref: '#/components/schemas/Result')
+        ),
+        new OA\Property(
+            property: 'links',
+            type: 'object',
+            properties: [
+                new OA\Property(property: 'first', type: 'string'),
+                new OA\Property(property: 'last', type: 'string'),
+                new OA\Property(property: 'prev', type: 'string', nullable: true),
+                new OA\Property(property: 'next', type: 'string', nullable: true),
+            ],
+            additionalProperties: false
+        ),
+        new OA\Property(
+            property: 'meta',
+            type: 'object',
+            properties: [
+                new OA\Property(property: 'current_page', type: 'integer'),
+                new OA\Property(property: 'from', type: 'integer'),
+                new OA\Property(property: 'last_page', type: 'integer'),
+                new OA\Property(
+                    property: 'links',
+                    type: 'array',
+                    items: new OA\Items(
+                        type: 'object',
+                        properties: [
+                            new OA\Property(property: 'url', type: 'string', nullable: true),
+                            new OA\Property(property: 'label', type: 'string'),
+                            new OA\Property(property: 'active', type: 'boolean'),
+                        ],
+                        additionalProperties: false
+                    )
+                ),
+                new OA\Property(property: 'path', type: 'string'),
+                new OA\Property(property: 'per_page', type: 'integer'),
+                new OA\Property(property: 'to', type: 'integer'),
+                new OA\Property(property: 'total', type: 'integer'),
+            ],
+            additionalProperties: false
+        ),
+    ],
+    additionalProperties: false
+)]
+class ResultsCollectionSchema {}
diff --git a/app/OpenApi/Schemas/ServersCollectionSchema.php b/app/OpenApi/Schemas/ServersCollectionSchema.php
new file mode 100644
index 000000000..5e97fe60c
--- /dev/null
+++ b/app/OpenApi/Schemas/ServersCollectionSchema.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'ServersCollection',
+    type: 'object',
+    description: 'Mapping of server IDs to display names',
+    properties: [
+        new OA\Property(
+            property: 'data',
+            type: 'object',
+            description: 'Map of server ID to display name',
+            example: [
+                'data' => [
+                    '12345' => 'Fibernet (New York, 12345)',
+                ],
+            ],
+        ),
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Response status message'
+        ),
+    ],
+    additionalProperties: false
+)]
+class ServersCollectionSchema {}
diff --git a/app/OpenApi/Schemas/SpeedtestRunSchema.php b/app/OpenApi/Schemas/SpeedtestRunSchema.php
new file mode 100644
index 000000000..0509802bd
--- /dev/null
+++ b/app/OpenApi/Schemas/SpeedtestRunSchema.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'SpeedtestRun',
+    type: 'object',
+    description: 'A queued speedtest result',
+    properties: [
+        new OA\Property(
+            property: 'data',
+            type: 'object',
+            description: 'Queued speedtest result payload',
+            properties: [
+                new OA\Property(property: 'id', type: 'integer'),
+                new OA\Property(property: 'service', type: 'string'),
+                new OA\Property(property: 'ping', type: 'number', format: 'float', nullable: true),
+                new OA\Property(property: 'download', type: 'integer', nullable: true),
+                new OA\Property(property: 'upload', type: 'integer', nullable: true),
+                new OA\Property(property: 'benchmarks', type: 'object', nullable: true),
+                new OA\Property(property: 'healthy', type: 'boolean', nullable: true),
+                new OA\Property(property: 'status', type: 'string'),
+                new OA\Property(property: 'scheduled', type: 'boolean'),
+                new OA\Property(property: 'comments', type: 'string', nullable: true),
+                new OA\Property(
+                    property: 'data',
+                    type: 'object',
+                    description: 'Additional data for queued result',
+                    properties: [
+                        new OA\Property(
+                            property: 'server',
+                            type: 'object',
+                            properties: [
+                                new OA\Property(property: 'id', type: 'integer', nullable: true),
+                            ]
+                        ),
+                    ]
+                ),
+                new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
+                new OA\Property(property: 'updated_at', type: 'string', format: 'date-time'),
+            ],
+            additionalProperties: false
+        ),
+        new OA\Property(property: 'message', type: 'string', description: 'Response status message'),
+    ],
+    additionalProperties: false
+)]
+class SpeedtestRunSchema {}
diff --git a/app/OpenApi/Schemas/StatsSchema.php b/app/OpenApi/Schemas/StatsSchema.php
new file mode 100644
index 000000000..82fd4ea0e
--- /dev/null
+++ b/app/OpenApi/Schemas/StatsSchema.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'Stats',
+    type: 'object',
+    description: 'Aggregated speedtest statistics',
+    properties: [
+        new OA\Property(property: 'total_results', type: 'integer'),
+        new OA\Property(property: 'avg_ping', type: 'number', format: 'float'),
+        new OA\Property(property: 'avg_download', type: 'number', format: 'float'),
+        new OA\Property(property: 'avg_upload', type: 'number', format: 'float'),
+        new OA\Property(property: 'min_ping', type: 'number', format: 'float'),
+        new OA\Property(property: 'min_download', type: 'number', format: 'float'),
+        new OA\Property(property: 'min_upload', type: 'number', format: 'float'),
+        new OA\Property(property: 'max_ping', type: 'number', format: 'float'),
+        new OA\Property(property: 'max_download', type: 'number', format: 'float'),
+        new OA\Property(property: 'max_upload', type: 'number', format: 'float'),
+    ]
+)]
+class StatsSchema {}
diff --git a/app/OpenApi/Schemas/UnauthenticatedErrorSchema.php b/app/OpenApi/Schemas/UnauthenticatedErrorSchema.php
new file mode 100644
index 000000000..8f81989a6
--- /dev/null
+++ b/app/OpenApi/Schemas/UnauthenticatedErrorSchema.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'UnauthenticatedError',
+    type: 'object',
+    description: 'Error when user is not authenticated',
+    properties: [
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Unauthenticated error message',
+        ),
+    ],
+)]
+class UnauthenticatedErrorSchema {}
diff --git a/app/OpenApi/Schemas/ValidationErrorSchema.php b/app/OpenApi/Schemas/ValidationErrorSchema.php
new file mode 100644
index 000000000..df5ce47b1
--- /dev/null
+++ b/app/OpenApi/Schemas/ValidationErrorSchema.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\OpenApi\Schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'ValidationError',
+    type: 'object',
+    description: 'Validation failed due to invalid server_id input',
+    properties: [
+        new OA\Property(
+            property: 'message',
+            type: 'string',
+            description: 'Validation failed due to invalid server_id input',
+        ),
+    ]
+)]
+
+class ValidationErrorSchema {}
diff --git a/openapi.json b/openapi.json
index f66c53cb2..3dbd4b26e 100644
--- a/openapi.json
+++ b/openapi.json
@@ -7,45 +7,862 @@
     "paths": {
         "/api/v1/results/latest": {
             "get": {
-                "description": "Get the latest result.",
-                "operationId": "4b44d6935caeb91d3e687ab4bc176f62",
+                "tags": [
+                    "Results"
+                ],
+                "summary": "Fetch the single most recent result",
+                "operationId": "getLatestResult",
                 "responses": {
                     "200": {
-                        "description": "OK"
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/Result"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
                     },
                     "404": {
-                        "description": "No result found"
+                        "description": "No result found",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NotFoundError"
+                                }
+                            }
+                        }
                     }
                 }
             }
         },
         "/api/v1/results": {
             "get": {
-                "description": "List results.",
-                "operationId": "32a45ba8e8e9a81955a178ae686273ce",
+                "tags": [
+                    "Results"
+                ],
+                "summary": "List results",
+                "operationId": "listResults",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ResultsCollection"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
+                    },
+                    "422": {
+                        "description": "Validation failed",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/ookla/list-servers": {
+            "get": {
+                "tags": [
+                    "Servers"
+                ],
+                "summary": "List available Ookla speedtest servers",
+                "operationId": "listSpeedtestServers",
                 "responses": {
                     "200": {
-                        "description": "OK"
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ServersCollection"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ForbiddenError"
+                                },
+                                "example": {
+                                    "message": "You do not have permission to view speedtest servers."
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/speedtests/run": {
+            "post": {
+                "tags": [
+                    "Speedtests"
+                ],
+                "summary": "Run a new Ookla speedtest",
+                "operationId": "runSpeedtest",
+                "parameters": [
+                    {
+                        "name": "server_id",
+                        "in": "query",
+                        "description": "Optional Ookla speedtest server ID",
+                        "required": false,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    }
+                ],
+                "responses": {
+                    "201": {
+                        "description": "Created",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/SpeedtestRun"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ForbiddenError"
+                                }
+                            }
+                        }
                     },
                     "422": {
-                        "description": "Unprocessable Entity"
+                        "description": "Validation error",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                }
+                            }
+                        }
                     }
                 }
             }
         },
         "/api/v1/results/{id}": {
             "get": {
-                "description": "Get result.",
-                "operationId": "bc182a4008f0ff94a6318893359f3adc",
+                "tags": [
+                    "Results"
+                ],
+                "summary": "Fetch a single result by ID",
+                "operationId": "getResult",
+                "parameters": [
+                    {
+                        "name": "id",
+                        "in": "path",
+                        "description": "The ID of the result",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    }
+                ],
                 "responses": {
                     "200": {
-                        "description": "OK"
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ResultResponse"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
                     },
                     "404": {
-                        "description": "Result not found"
+                        "description": "Result not found",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NotFoundError"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/stats": {
+            "get": {
+                "tags": [
+                    "Stats"
+                ],
+                "summary": "Fetch aggregated Speedtest statistics",
+                "description": "Handle the incoming request.",
+                "operationId": "getStats",
+                "parameters": [
+                    {
+                        "name": "start_at",
+                        "in": "query",
+                        "description": "ISO‑8601 start datetime filter",
+                        "required": false,
+                        "schema": {
+                            "type": "string",
+                            "format": "date-time"
+                        }
+                    },
+                    {
+                        "name": "end_at",
+                        "in": "query",
+                        "description": "ISO‑8601 end datetime filter",
+                        "required": false,
+                        "schema": {
+                            "type": "string",
+                            "format": "date-time"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/Stats"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthenticated",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthenticatedError"
+                                }
+                            }
+                        }
+                    },
+                    "422": {
+                        "description": "Validation failed",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationError"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "ForbiddenError": {
+                "description": "Forbidden error response when user lacks permission",
+                "properties": {
+                    "message": {
+                        "description": "Error message indicating lack of permission",
+                        "type": "string"
+                    }
+                },
+                "type": "object"
+            },
+            "NotFoundError": {
+                "description": "Error when a requested result is not found",
+                "properties": {
+                    "message": {
+                        "description": "Result not found error message",
+                        "type": "string"
+                    }
+                },
+                "type": "object"
+            },
+            "ResultResponse": {
+                "description": "Response for an Single Speedtest result entry",
+                "properties": {
+                    "data": {
+                        "$ref": "#/components/schemas/Result"
+                    },
+                    "message": {
+                        "description": "Response status message",
+                        "type": "string"
+                    }
+                },
+                "type": "object"
+            },
+            "Result": {
+                "description": "Speedtest result entry",
+                "properties": {
+                    "id": {
+                        "type": "integer"
+                    },
+                    "service": {
+                        "type": "string"
+                    },
+                    "ping": {
+                        "type": "number"
+                    },
+                    "download": {
+                        "type": "integer"
+                    },
+                    "upload": {
+                        "type": "integer"
+                    },
+                    "download_bits": {
+                        "type": "integer"
+                    },
+                    "upload_bits": {
+                        "type": "integer"
+                    },
+                    "download_bits_human": {
+                        "type": "string"
+                    },
+                    "upload_bits_human": {
+                        "type": "string"
+                    },
+                    "benchmarks": {
+                        "type": "array",
+                        "items": {
+                            "type": "object"
+                        },
+                        "nullable": true
+                    },
+                    "healthy": {
+                        "type": "boolean",
+                        "nullable": true
+                    },
+                    "status": {
+                        "type": "string"
+                    },
+                    "scheduled": {
+                        "type": "boolean"
+                    },
+                    "comments": {
+                        "type": "string",
+                        "nullable": true
+                    },
+                    "data": {
+                        "description": "Nested speedtest data payload",
+                        "properties": {
+                            "isp": {
+                                "type": "string"
+                            },
+                            "ping": {
+                                "properties": {
+                                    "low": {
+                                        "type": "number",
+                                        "format": "float"
+                                    },
+                                    "high": {
+                                        "type": "number",
+                                        "format": "float"
+                                    },
+                                    "jitter": {
+                                        "type": "number",
+                                        "format": "float"
+                                    },
+                                    "latency": {
+                                        "type": "number",
+                                        "format": "float"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "type": {
+                                "type": "string"
+                            },
+                            "result": {
+                                "properties": {
+                                    "id": {
+                                        "type": "string"
+                                    },
+                                    "url": {
+                                        "type": "string",
+                                        "format": "uri"
+                                    },
+                                    "persisted": {
+                                        "type": "boolean"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "server": {
+                                "properties": {
+                                    "id": {
+                                        "type": "integer"
+                                    },
+                                    "ip": {
+                                        "type": "string",
+                                        "format": "ipv4"
+                                    },
+                                    "host": {
+                                        "type": "string"
+                                    },
+                                    "name": {
+                                        "type": "string"
+                                    },
+                                    "port": {
+                                        "type": "integer"
+                                    },
+                                    "country": {
+                                        "type": "string"
+                                    },
+                                    "location": {
+                                        "type": "string"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "upload": {
+                                "properties": {
+                                    "bytes": {
+                                        "type": "integer"
+                                    },
+                                    "elapsed": {
+                                        "type": "integer"
+                                    },
+                                    "latency": {
+                                        "properties": {
+                                            "iqm": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "low": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "high": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "jitter": {
+                                                "type": "number",
+                                                "format": "float"
+                                            }
+                                        },
+                                        "type": "object"
+                                    },
+                                    "bandwidth": {
+                                        "type": "integer"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "download": {
+                                "properties": {
+                                    "bytes": {
+                                        "type": "integer"
+                                    },
+                                    "elapsed": {
+                                        "type": "integer"
+                                    },
+                                    "latency": {
+                                        "properties": {
+                                            "iqm": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "low": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "high": {
+                                                "type": "number",
+                                                "format": "float"
+                                            },
+                                            "jitter": {
+                                                "type": "number",
+                                                "format": "float"
+                                            }
+                                        },
+                                        "type": "object"
+                                    },
+                                    "bandwidth": {
+                                        "type": "integer"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "interface": {
+                                "properties": {
+                                    "name": {
+                                        "type": "string"
+                                    },
+                                    "isVpn": {
+                                        "type": "boolean"
+                                    },
+                                    "macAddr": {
+                                        "type": "string",
+                                        "pattern": "^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$"
+                                    },
+                                    "externalIp": {
+                                        "type": "string",
+                                        "format": "ipv4"
+                                    },
+                                    "internalIp": {
+                                        "type": "string",
+                                        "format": "ipv4"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "timestamp": {
+                                "type": "string",
+                                "format": "date-time"
+                            },
+                            "packetLoss": {
+                                "type": "number"
+                            }
+                        },
+                        "type": "object"
+                    },
+                    "created_at": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                    }
+                },
+                "type": "object",
+                "additionalProperties": false
+            },
+            "ResultsCollection": {
+                "description": "Paginated list of Speedtest results",
+                "properties": {
+                    "data": {
+                        "description": "Array of result objects",
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/Result"
+                        }
+                    },
+                    "links": {
+                        "properties": {
+                            "first": {
+                                "type": "string"
+                            },
+                            "last": {
+                                "type": "string"
+                            },
+                            "prev": {
+                                "type": "string",
+                                "nullable": true
+                            },
+                            "next": {
+                                "type": "string",
+                                "nullable": true
+                            }
+                        },
+                        "type": "object",
+                        "additionalProperties": false
+                    },
+                    "meta": {
+                        "properties": {
+                            "current_page": {
+                                "type": "integer"
+                            },
+                            "from": {
+                                "type": "integer"
+                            },
+                            "last_page": {
+                                "type": "integer"
+                            },
+                            "links": {
+                                "type": "array",
+                                "items": {
+                                    "properties": {
+                                        "url": {
+                                            "type": "string",
+                                            "nullable": true
+                                        },
+                                        "label": {
+                                            "type": "string"
+                                        },
+                                        "active": {
+                                            "type": "boolean"
+                                        }
+                                    },
+                                    "type": "object",
+                                    "additionalProperties": false
+                                }
+                            },
+                            "path": {
+                                "type": "string"
+                            },
+                            "per_page": {
+                                "type": "integer"
+                            },
+                            "to": {
+                                "type": "integer"
+                            },
+                            "total": {
+                                "type": "integer"
+                            }
+                        },
+                        "type": "object",
+                        "additionalProperties": false
+                    }
+                },
+                "type": "object",
+                "additionalProperties": false
+            },
+            "ServersCollection": {
+                "description": "Mapping of server IDs to display names",
+                "properties": {
+                    "data": {
+                        "description": "Map of server ID to display name",
+                        "type": "object",
+                        "example": {
+                            "data": {
+                                "12345": "Fibernet (New York, 12345)"
+                            }
+                        }
+                    },
+                    "message": {
+                        "description": "Response status message",
+                        "type": "string"
+                    }
+                },
+                "type": "object",
+                "additionalProperties": false
+            },
+            "SpeedtestRun": {
+                "description": "A queued speedtest result",
+                "properties": {
+                    "data": {
+                        "description": "Queued speedtest result payload",
+                        "properties": {
+                            "id": {
+                                "type": "integer"
+                            },
+                            "service": {
+                                "type": "string"
+                            },
+                            "ping": {
+                                "type": "number",
+                                "format": "float",
+                                "nullable": true
+                            },
+                            "download": {
+                                "type": "integer",
+                                "nullable": true
+                            },
+                            "upload": {
+                                "type": "integer",
+                                "nullable": true
+                            },
+                            "benchmarks": {
+                                "type": "object",
+                                "nullable": true
+                            },
+                            "healthy": {
+                                "type": "boolean",
+                                "nullable": true
+                            },
+                            "status": {
+                                "type": "string"
+                            },
+                            "scheduled": {
+                                "type": "boolean"
+                            },
+                            "comments": {
+                                "type": "string",
+                                "nullable": true
+                            },
+                            "data": {
+                                "description": "Additional data for queued result",
+                                "properties": {
+                                    "server": {
+                                        "properties": {
+                                            "id": {
+                                                "type": "integer",
+                                                "nullable": true
+                                            }
+                                        },
+                                        "type": "object"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "created_at": {
+                                "type": "string",
+                                "format": "date-time"
+                            },
+                            "updated_at": {
+                                "type": "string",
+                                "format": "date-time"
+                            }
+                        },
+                        "type": "object",
+                        "additionalProperties": false
+                    },
+                    "message": {
+                        "description": "Response status message",
+                        "type": "string"
+                    }
+                },
+                "type": "object",
+                "additionalProperties": false
+            },
+            "Stats": {
+                "description": "Aggregated speedtest statistics",
+                "properties": {
+                    "total_results": {
+                        "type": "integer"
+                    },
+                    "avg_ping": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "avg_download": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "avg_upload": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "min_ping": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "min_download": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "min_upload": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "max_ping": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "max_download": {
+                        "type": "number",
+                        "format": "float"
+                    },
+                    "max_upload": {
+                        "type": "number",
+                        "format": "float"
                     }
+                },
+                "type": "object"
+            },
+            "UnauthenticatedError": {
+                "description": "Error when user is not authenticated",
+                "properties": {
+                    "message": {
+                        "description": "Unauthenticated error message",
+                        "type": "string"
+                    }
+                },
+                "type": "object"
+            },
+            "ValidationError": {
+                "description": "Validation failed due to invalid server_id input",
+                "properties": {
+                    "message": {
+                        "description": "Validation failed due to invalid server_id input",
+                        "type": "string"
+                    }
+                },
+                "type": "object"
+            }
+        },
+        "parameters": {
+            "Accept": {
+                "name": "Accept",
+                "in": "header",
+                "description": "Expected response format",
+                "required": true,
+                "schema": {
+                    "type": "string",
+                    "default": "application/json"
                 }
             }
+        },
+        "securitySchemes": {
+            "bearerAuth": {
+                "type": "http",
+                "bearerFormat": "JWT",
+                "scheme": "bearer"
+            }
+        }
+    },
+    "tags": [
+        {
+            "name": "Results",
+            "description": "Operations related to Speedtest results.\nRequires an API token with scope `results:read`."
+        },
+        {
+            "name": "Speedtests",
+            "description": "Operations to run speedtests.\nRequires an API token with scope `speedtests:run`."
+        },
+        {
+            "name": "Servers",
+            "description": "Operations for speedtest servers.\nRequires an API token with scope `ookla:list-servers`."
+        },
+        {
+            "name": "Stats",
+            "description": "Operations for statistics.\nRequires an API token with scope `results:read`."
         }
-    }
+    ]
 }
\ No newline at end of file