From ede0fc4cf420911c726f625fa29f277a99906400 Mon Sep 17 00:00:00 2001
From: Ahmedhossamdev <ahmedhossamdev1@gmail.com>
Date: Fri, 29 Nov 2024 14:03:31 -0800
Subject: [PATCH] feat: Add API endpoint for retrieving stops by agency ID and
 update response schemas

---
 openapi.yml | 74 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 39 insertions(+), 35 deletions(-)

diff --git a/openapi.yml b/openapi.yml
index 238337c..56894e4 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -750,6 +750,26 @@ paths:
                   - $ref: '#/components/schemas/ResponseWrapper'
                   - $ref: '#/components/schemas/StopsForRouteResponse'
 
+  /api/where/stops-for-agency/{agencyID}.json:
+    parameters:
+      - name: agencyID
+        in: path
+        required: true
+        schema:
+          type: string
+        description: ID of the agency
+    get:
+      summary: Get stops for a specific agency
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/ResponseWrapper'
+                  - $ref: '#/components/schemas/StopsForAgencyResponse'
+
   /api/where/stop/{stopID}.json:
     parameters:
       - name: stopID
@@ -1501,11 +1521,13 @@ components:
         wheelchairBoarding:
           type: string
       required:
-        - code
         - id
         - lat
         - lon
         - name
+        - parent
+        - routeIds
+        - staticRouteIds
 
     Trip:
       type: object
@@ -1603,53 +1625,35 @@ components:
         - entry
         - references
 
-    StopsForLocation:
+    StopsForLocationResponse:
       type: object
       properties:
-        code:
-          type: string
-        direction:
-          type: string
-        id:
-          type: string
-        lat:
-          type: number
-        locationType:
-          type: integer
-        lon:
-          type: number
-        name:
-          type: string
-        parent:
-          type: string
-        routeIds:
-          type: array
-          items:
-            type: string
-        staticRouteIds:
+        limitExceeded:
+          type: boolean
+        outOfRange:
+          type: boolean
+        list:
           type: array
           items:
-            type: string
-        wheelchairBoarding:
-          type: string
+            $ref: '#/components/schemas/Stop'
+        references:
+          $ref: '#/components/schemas/Reference'
       required:
-        - id
-        - lat
-        - lon
-        - name
-        - parent
-        - routeIds
-        - staticRouteIds
+        - list
+        - references
+        - limitExceeded
 
-    StopsForLocationResponse:
+    StopsForAgencyResponse:
       type: object
       properties:
         limitExceeded:
           type: boolean
+        outOfRange:
+          type: boolean
         list:
           type: array
           items:
-            $ref: '#/components/schemas/StopsForLocation'
+            $ref: '#/components/schemas/Stop'
         references:
           $ref: '#/components/schemas/Reference'
       required: