From df4e603537ff53a421b37906379da731f57f3d0a Mon Sep 17 00:00:00 2001
From: Jose Andres Tejerina <andres.tejerina@exomindset.co>
Date: Thu, 13 Nov 2025 13:53:49 -0300
Subject: [PATCH 1/2] feat: Extend Swagger Coverage for controller
 TimezonesApiController

---
 .../Apis/TimezonesApiController.php           | 30 ++++++++++++++++
 app/Swagger/TimezonesSchemas.php              | 36 +++++++++++++++++++
 2 files changed, 66 insertions(+)
 create mode 100644 app/Swagger/TimezonesSchemas.php

diff --git a/app/Http/Controllers/Apis/TimezonesApiController.php b/app/Http/Controllers/Apis/TimezonesApiController.php
index 92acd5a2b..f7522df43 100644
--- a/app/Http/Controllers/Apis/TimezonesApiController.php
+++ b/app/Http/Controllers/Apis/TimezonesApiController.php
@@ -1,4 +1,5 @@
 <?php namespace App\Http\Controllers;
+
 /**
  * Copyright 2021 OpenStack Foundation
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -17,6 +18,9 @@
 use models\exceptions\EntityNotFoundException;
 use models\exceptions\ValidationException;
 use utils\PagingResponse;
+use OpenApi\Attributes as OA;
+use Symfony\Component\HttpFoundation\Response;
+
 /**
  * Class TimezonesApiController
  * @package App\Http\Controllers
@@ -26,6 +30,32 @@ final class TimezonesApiController extends JsonController
     /**
      * @return mixed
      */
+    #[OA\Get(
+        path: '/api/v1/timezones',
+        operationId: 'getTimezones',
+        description: 'Retrieve all available timezones',
+        tags: ['Timezones'],
+        parameters: [
+            new OA\Parameter(
+                name: 'expand',
+                description: 'Expansion parameters',
+                in: 'query',
+                required: false,
+                schema: new OA\Schema(type: 'string')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'List of all available timezones',
+                content: new OA\JsonContent(ref: '#/components/schemas/TimezonesResponse')
+            ),
+            new OA\Response(
+                response: Response::HTTP_INTERNAL_SERVER_ERROR,
+                description: 'Server Error'
+            ),
+        ]
+    )]
     public function getAll(){
         try {
             $timezones   = \DateTimeZone::listIdentifiers();
diff --git a/app/Swagger/TimezonesSchemas.php b/app/Swagger/TimezonesSchemas.php
new file mode 100644
index 000000000..3a55b2dc2
--- /dev/null
+++ b/app/Swagger/TimezonesSchemas.php
@@ -0,0 +1,36 @@
+<?php 
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'TimezonesResponse',
+    type: 'object',
+    properties: [
+        new OA\Property(
+            property: 'data',
+            type: 'array',
+            items: new OA\Items(type: 'string', example: 'America/New_York'),
+            description: 'Array of all available timezone identifiers'
+        ),
+        new OA\Property(
+            property: 'total',
+            type: 'integer',
+            example: 427,
+            description: 'Total number of available timezones'
+        ),
+        new OA\Property(
+            property: 'current_page',
+            type: 'integer',
+            example: 1,
+            description: 'Current page number'
+        ),
+        new OA\Property(
+            property: 'last_page',
+            type: 'integer',
+            example: 1,
+            description: 'Last page number'
+        ),
+    ]
+)]
+class TimezonesResponseSchema {}
\ No newline at end of file

From bac26413ab6b74a57352550283d202e2e550bc3c Mon Sep 17 00:00:00 2001
From: Matias Perrone <github@matiasperrone.com>
Date: Fri, 5 Dec 2025 20:44:53 +0000
Subject: [PATCH 2/2] fix: route path

---
 app/Http/Controllers/Apis/TimezonesApiController.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/app/Http/Controllers/Apis/TimezonesApiController.php b/app/Http/Controllers/Apis/TimezonesApiController.php
index f7522df43..cc7832d50 100644
--- a/app/Http/Controllers/Apis/TimezonesApiController.php
+++ b/app/Http/Controllers/Apis/TimezonesApiController.php
@@ -31,10 +31,10 @@ final class TimezonesApiController extends JsonController
      * @return mixed
      */
     #[OA\Get(
-        path: '/api/v1/timezones',
+        path: '/api/public/v1/timezones',
         operationId: 'getTimezones',
         description: 'Retrieve all available timezones',
-        tags: ['Timezones'],
+        tags: ['Timezones (Public)'],
         parameters: [
             new OA\Parameter(
                 name: 'expand',
@@ -84,4 +84,4 @@ public function getAll(){
             return $this->error500($ex);
         }
     }
-}
\ No newline at end of file
+}