@sparkrewards/sra-sdk 0.0.1

package/dist-cjs/openapi.json

@@ -0,0 +1,2864 @@
+{
+    "openapi": "3.1.0",
+    "info": {
+        "title": "Spark Rewards App API Structure",
+        "version": "2025-10-29",
+        "description": "Spark Rewards APP API Service"
+    },
+    "paths": {
+        "/plan": {
+            "get": {
+                "description": "Retrieves the reward plan details for a specific organization, including visits, points, and redeemable rewards for the authenticated user.",
+                "operationId": "Plan",
+                "parameters": [
+                    {
+                        "name": "org_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Plan 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PlanResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/plans": {
+            "get": {
+                "description": "Retrieves a paginated list of all reward plans associated with the authenticated user, ordered by nearest shop location.",
+                "operationId": "Plans",
+                "parameters": [
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "limit",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Plans 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PlansResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/plans/favorite": {
+            "get": {
+                "description": "Retrieves a paginated list of reward plans for organizations that the authenticated user has marked as favorites, ordered by nearest shop location.",
+                "operationId": "FavoritePlans",
+                "parameters": [
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "limit",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "FavoritePlans 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/FavoritePlansResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/plan": {
+            "get": {
+                "description": "Retrieves the reward plan details for a specific organization, including visits, points for any user.",
+                "operationId": "PlanPublic",
+                "parameters": [
+                    {
+                        "name": "org_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "PlanPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PlanPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops": {
+            "get": {
+                "description": "Public endpoint: Retrieves a paginated list of active shops ordered by distance from the provided location coordinates. Returns enriched shop data with organization information. No authentication required.",
+                "operationId": "NearbyShopsPublic",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "NearbyShopsPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NearbyShopsPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/pinned": {
+            "get": {
+                "description": "Retrieves the pinned shop details for the authenticated user. Returns enriched shop data with organization information.",
+                "operationId": "PinnedShopPublic",
+                "parameters": [
+                    {
+                        "name": "shop_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "PinnedShopPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PinnedShopPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/popular": {
+            "get": {
+                "description": "Retrieves a paginated list of popular shops ordered by distance from the provided location coordinates. Returns enriched shop data with organization information.",
+                "operationId": "PopularShopsPublic",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "PopularShopsPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PopularShopsPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/radius": {
+            "get": {
+                "description": "Retrieves shops within a specified radius from the provided location coordinates. Returns enriched shop data with organization information.",
+                "operationId": "RadiusShops",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "RadiusShops 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RadiusShopsResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/search": {
+            "get": {
+                "description": "Retrieves a paginated list of shops based on the provided search query. Returns enriched shop data with organization information.",
+                "operationId": "SearchShopsPublic",
+                "parameters": [
+                    {
+                        "name": "q",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "limit",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "SearchShopsPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/SearchShopsPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/search/suggestion": {
+            "get": {
+                "description": "Retrieves search suggestions for shops based on the provided search query. Returns matching shop and organization names.",
+                "operationId": "SearchSuggestion",
+                "parameters": [
+                    {
+                        "name": "q",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "limit",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "SearchSuggestion 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/SearchSuggestionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/public/shops/shop/{shop_id}": {
+            "get": {
+                "description": "Retrieves detailed information for a specific shop by its ID, including organization details, menu, location, and shop hours.",
+                "operationId": "GetShopPublic",
+                "parameters": [
+                    {
+                        "name": "shop_id",
+                        "in": "path",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "GetShopPublic 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/GetShopPublicResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "NotFoundError 404 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/rewards/redeem/first-time": {
+            "put": {
+                "description": "Redeems a first-time reward for the authenticated user from a specific organization. This can only be redeemed once per user per organization.",
+                "operationId": "RedeemFirstTimeReward",
+                "parameters": [
+                    {
+                        "name": "org_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "RedeemFirstTimeReward 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RedeemFirstTimeRewardResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/rewards/redeem/point": {
+            "put": {
+                "description": "Redeems a point-based reward for the authenticated user using accumulated points. The required points are deducted from the user's total points balance.",
+                "operationId": "RedeemPointReward",
+                "parameters": [
+                    {
+                        "name": "org_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "reward_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "RedeemPointReward 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RedeemPointRewardResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/rewards/redeem/visit": {
+            "put": {
+                "description": "Redeems a visit-based reward for the authenticated user. This reward is earned after completing the required number of visits for a reward plan.",
+                "operationId": "RedeemVisitReward",
+                "parameters": [
+                    {
+                        "name": "reward_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "RedeemVisitReward 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RedeemVisitRewardResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops": {
+            "get": {
+                "description": "Retrieves a paginated list of active shops ordered by distance from the provided location coordinates. Returns enriched shop data with organization information.",
+                "operationId": "NearbyShops",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "NearbyShops 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NearbyShopsResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops/favorite": {
+            "get": {
+                "description": "Retrieves a paginated list of shops from organizations that the authenticated user has marked as favorites, ordered by distance from the provided location coordinates.",
+                "operationId": "FavoriteShops",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "FavoriteShops 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/FavoriteShopsResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops/nearest": {
+            "get": {
+                "description": "Retrieves the single nearest active shop to the provided location coordinates for a specific organization.",
+                "operationId": "NearestShop",
+                "parameters": [
+                    {
+                        "name": "shop_name",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "NearestShop 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NearestShopResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops/pinned": {
+            "get": {
+                "description": "Retrieves the pinned shop details for the authenticated user. Returns enriched shop data with organization information.",
+                "operationId": "PinnedShop",
+                "parameters": [
+                    {
+                        "name": "shop_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "PinnedShop 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PinnedShopResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops/popular": {
+            "get": {
+                "description": "Retrieves a paginated list of popular shops ordered by distance from the provided location coordinates. Returns enriched shop data with organization information.",
+                "operationId": "PopularShops",
+                "parameters": [
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        }
+                    },
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "number"
+                        }
+                    },
+                    {
+                        "name": "filters",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "PopularShops 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/PopularShopsResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/shops/shop/{shop_id}": {
+            "get": {
+                "description": "Retrieves detailed information for a specific shop by its ID, including organization details, menu, location, and shop hours.",
+                "operationId": "GetShop",
+                "parameters": [
+                    {
+                        "name": "shop_id",
+                        "in": "path",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "GetShop 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/GetShopResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "404": {
+                        "description": "NotFoundError 404 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/user": {
+            "delete": {
+                "description": "Permanently deletes the authenticated user's account and all associated data from the system. This action cannot be undone.",
+                "operationId": "DeleteUser",
+                "responses": {
+                    "200": {
+                        "description": "DeleteUser 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/DeleteUserResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+            "get": {
+                "description": "Retrieves the authenticated user's profile information, including personal details, preferences, visit statistics, and reward counts.",
+                "operationId": "GetUser",
+                "responses": {
+                    "200": {
+                        "description": "GetUser 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/GetUserResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+            "put": {
+                "description": "Updates the authenticated user's profile information, including personal details and preferences. Only provided fields will be updated.",
+                "operationId": "UpdateUser",
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/UpdateUserRequestContent"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "UpdateUser 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UpdateUserResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/user/like": {
+            "put": {
+                "description": "Toggles the like status for an organization. If the organization is already liked, it will be unliked, and vice versa. Returns the current like status.",
+                "operationId": "LikeOrg",
+                "parameters": [
+                    {
+                        "name": "org_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "LikeOrg 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/LikeOrgResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/user/onboard": {
+            "put": {
+                "description": "Completes the onboarding process for a new user by marking their account as no longer new. Updates the user's newAccount status and returns the updated user profile.",
+                "operationId": "OnboardUser",
+                "responses": {
+                    "200": {
+                        "description": "OnboardUser 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/OnboardUserResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "ValidationException 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ValidationExceptionResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/visit": {
+            "post": {
+                "description": "Records a visit to a shop for the authenticated user. Updates visit counts, tracks spending, awards points, and triggers rewards when thresholds are met. Also handles first-time rewards and visit-based rewards.",
+                "operationId": "RecordVisit",
+                "parameters": [
+                    {
+                        "name": "shop_id",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "timestamp",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lat",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    },
+                    {
+                        "name": "lon",
+                        "in": "query",
+                        "schema": {
+                            "type": "number",
+                            "format": "double"
+                        },
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "RecordVisit 200 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RecordVisitResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "InvalidOperationError 400 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/InvalidOperationErrorResponseContent"
+                                }
+                            }
+                        }
+                    },
+                    "500": {
+                        "description": "RuntimeError 500 response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/RuntimeErrorResponseContent"
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "DeleteUserResponseContent": {
+                "type": "object",
+                "description": "Output for DeleteUser",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    }
+                }
+            },
+            "EnrichedShop": {
+                "type": "object",
+                "description": "Base shop structure returned from enrichList/enrichSingle",
+                "properties": {
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "distance": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "distance",
+                    "location",
+                    "name",
+                    "org_id",
+                    "preview",
+                    "shop_hours",
+                    "shop_id",
+                    "tags"
+                ]
+            },
+            "FavoritePlansResponseContent": {
+                "type": "object",
+                "properties": {
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/GroupedPlan"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                },
+                "required": [
+                    "count",
+                    "pagination",
+                    "value"
+                ]
+            },
+            "FavoriteShopsResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "FirstTimeReward": {
+                "type": "object",
+                "properties": {
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "description": {
+                        "type": "string"
+                    }
+                }
+            },
+            "GetShopPublicResponseContent": {
+                "type": "object",
+                "description": "Full shop details structure",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "shop_name": {
+                        "type": "string"
+                    },
+                    "org_name": {
+                        "type": "string"
+                    },
+                    "banner": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "country_code": {
+                        "type": "string"
+                    },
+                    "latitude": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "longitude": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "menu": {
+                        "type": "string"
+                    },
+                    "phone_number": {
+                        "type": "string"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "sent_setup": {
+                        "type": "boolean"
+                    },
+                    "setup": {
+                        "type": "boolean"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "active",
+                    "country_code",
+                    "description",
+                    "id",
+                    "location",
+                    "logo",
+                    "longitude",
+                    "org_id",
+                    "org_name",
+                    "preview",
+                    "setup",
+                    "shop_hours",
+                    "shop_name",
+                    "tags"
+                ]
+            },
+            "GetShopResponseContent": {
+                "type": "object",
+                "description": "Full shop details structure",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "shop_name": {
+                        "type": "string"
+                    },
+                    "org_name": {
+                        "type": "string"
+                    },
+                    "banner": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "country_code": {
+                        "type": "string"
+                    },
+                    "latitude": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "longitude": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "menu": {
+                        "type": "string"
+                    },
+                    "phone_number": {
+                        "type": "string"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "sent_setup": {
+                        "type": "boolean"
+                    },
+                    "setup": {
+                        "type": "boolean"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "active",
+                    "country_code",
+                    "description",
+                    "id",
+                    "location",
+                    "logo",
+                    "longitude",
+                    "org_id",
+                    "org_name",
+                    "preview",
+                    "setup",
+                    "shop_hours",
+                    "shop_name",
+                    "tags"
+                ]
+            },
+            "GetUserResponseContent": {
+                "type": "object",
+                "description": "Output for GetUser",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "user": {
+                        "$ref": "#/components/schemas/User"
+                    }
+                }
+            },
+            "GroupedPlan": {
+                "type": "object",
+                "properties": {
+                    "reward_plan": {
+                        "$ref": "#/components/schemas/RewardPlan"
+                    },
+                    "visits": {
+                        "type": "number"
+                    },
+                    "points": {
+                        "type": "number"
+                    },
+                    "redeemableRewards": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/Reward"
+                        }
+                    },
+                    "visits_active": {
+                        "type": "boolean"
+                    },
+                    "points_active": {
+                        "type": "boolean"
+                    },
+                    "banner": {
+                        "type": "string"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "id": {
+                        "type": "string"
+                    },
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "num_redeemableRewards": {
+                        "type": "number"
+                    }
+                },
+                "required": [
+                    "active",
+                    "banner",
+                    "favorite",
+                    "id",
+                    "logo",
+                    "name",
+                    "num_redeemableRewards",
+                    "org_id",
+                    "points",
+                    "points_active",
+                    "redeemableRewards",
+                    "reward_plan",
+                    "shop_id",
+                    "visits",
+                    "visits_active"
+                ]
+            },
+            "InvalidOperationErrorResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    }
+                }
+            },
+            "LikeOrgResponseContent": {
+                "type": "object",
+                "description": "Output for LikeOrg",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "liked": {
+                        "type": "boolean"
+                    }
+                }
+            },
+            "LocationDetails": {
+                "type": "object",
+                "description": "Location details for a shop",
+                "properties": {
+                    "address": {
+                        "type": "string"
+                    },
+                    "city": {
+                        "type": "string"
+                    },
+                    "state": {
+                        "type": "string"
+                    },
+                    "zipcode": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "address",
+                    "city",
+                    "state",
+                    "zipcode"
+                ]
+            },
+            "NearbyShopsPublicResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "NearbyShopsResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "NearestShopResponseContent": {
+                "type": "object",
+                "description": "Base shop structure returned from enrichList/enrichSingle",
+                "properties": {
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "distance": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "distance",
+                    "location",
+                    "name",
+                    "org_id",
+                    "preview",
+                    "shop_hours",
+                    "shop_id",
+                    "tags"
+                ]
+            },
+            "NotFoundErrorResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    }
+                }
+            },
+            "OnboardUserResponseContent": {
+                "type": "object",
+                "description": "Output for OnboardUser",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "user": {
+                        "$ref": "#/components/schemas/User"
+                    }
+                }
+            },
+            "PaginationInfo": {
+                "type": "object",
+                "properties": {
+                    "currentPage": {
+                        "type": "number"
+                    },
+                    "limit": {
+                        "type": "number"
+                    },
+                    "hasMore": {
+                        "type": "boolean"
+                    },
+                    "nextPage": {
+                        "type": "number",
+                        "description": "The next page number, or null if there are no more pages"
+                    }
+                },
+                "required": [
+                    "hasMore",
+                    "limit",
+                    "nextPage"
+                ]
+            },
+            "PinnedShopPublicResponseContent": {
+                "type": "object",
+                "description": "Base shop structure returned from enrichList/enrichSingle",
+                "properties": {
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "distance": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "distance",
+                    "location",
+                    "name",
+                    "org_id",
+                    "preview",
+                    "shop_hours",
+                    "shop_id",
+                    "tags"
+                ]
+            },
+            "PinnedShopResponseContent": {
+                "type": "object",
+                "description": "Base shop structure returned from enrichList/enrichSingle",
+                "properties": {
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "org_id": {
+                        "type": "string"
+                    },
+                    "preview": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "distance": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "location": {
+                        "$ref": "#/components/schemas/LocationDetails"
+                    },
+                    "shop_hours": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopHoursItem"
+                        },
+                        "description": "List of shop hours for all days"
+                    },
+                    "logo": {
+                        "type": "string"
+                    },
+                    "tags": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "distance",
+                    "location",
+                    "name",
+                    "org_id",
+                    "preview",
+                    "shop_hours",
+                    "shop_id",
+                    "tags"
+                ]
+            },
+            "PlanPublicResponseContent": {
+                "type": "object",
+                "properties": {
+                    "reward_plan": {
+                        "$ref": "#/components/schemas/RewardPlan"
+                    },
+                    "visits": {
+                        "type": "number"
+                    },
+                    "points": {
+                        "type": "number"
+                    },
+                    "redeemableRewards": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/Reward"
+                        }
+                    },
+                    "min_spend": {
+                        "type": "number"
+                    },
+                    "visits_active": {
+                        "type": "boolean"
+                    },
+                    "points_active": {
+                        "type": "boolean"
+                    },
+                    "firstPlan": {
+                        "type": "boolean"
+                    },
+                    "id": {
+                        "type": "string"
+                    },
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "organization_id": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "first_time_reward": {
+                        "$ref": "#/components/schemas/FirstTimeReward"
+                    }
+                },
+                "required": [
+                    "active",
+                    "favorite",
+                    "firstPlan",
+                    "first_time_reward",
+                    "id",
+                    "name",
+                    "points",
+                    "points_active",
+                    "redeemableRewards",
+                    "reward_plan",
+                    "visits",
+                    "visits_active"
+                ]
+            },
+            "PlanResponseContent": {
+                "type": "object",
+                "properties": {
+                    "reward_plan": {
+                        "$ref": "#/components/schemas/RewardPlan"
+                    },
+                    "visits": {
+                        "type": "number"
+                    },
+                    "points": {
+                        "type": "number"
+                    },
+                    "redeemableRewards": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/Reward"
+                        }
+                    },
+                    "min_spend": {
+                        "type": "number"
+                    },
+                    "visits_active": {
+                        "type": "boolean"
+                    },
+                    "points_active": {
+                        "type": "boolean"
+                    },
+                    "firstPlan": {
+                        "type": "boolean"
+                    },
+                    "id": {
+                        "type": "string"
+                    },
+                    "active": {
+                        "type": "boolean"
+                    },
+                    "organization_id": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "first_time_reward": {
+                        "$ref": "#/components/schemas/FirstTimeReward"
+                    }
+                },
+                "required": [
+                    "active",
+                    "favorite",
+                    "firstPlan",
+                    "first_time_reward",
+                    "id",
+                    "name",
+                    "points",
+                    "points_active",
+                    "redeemableRewards",
+                    "reward_plan",
+                    "visits",
+                    "visits_active"
+                ]
+            },
+            "PlansResponseContent": {
+                "type": "object",
+                "properties": {
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/GroupedPlan"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                },
+                "required": [
+                    "count",
+                    "pagination",
+                    "value"
+                ]
+            },
+            "PointsRewardOption": {
+                "type": "object",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "reward": {
+                        "type": "string"
+                    },
+                    "points": {
+                        "type": "number"
+                    }
+                },
+                "required": [
+                    "id",
+                    "points",
+                    "reward"
+                ]
+            },
+            "PopularShopsPublicResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "PopularShopsResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "RadiusShopsResponseContent": {
+                "type": "object",
+                "description": "Output for RadiusShops (simple location list)",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ShopLocation"
+                        }
+                    }
+                }
+            },
+            "RecordVisitResponseContent": {
+                "type": "object",
+                "description": "Output for RecordVisit",
+                "properties": {
+                    "success": {
+                        "type": "boolean"
+                    },
+                    "message": {
+                        "type": "string"
+                    },
+                    "visitId": {
+                        "type": "string"
+                    },
+                    "reason": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "message",
+                    "success",
+                    "visitId"
+                ]
+            },
+            "RedeemFirstTimeRewardResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "redeemed": {
+                        "type": "boolean"
+                    }
+                },
+                "required": [
+                    "message",
+                    "redeemed"
+                ]
+            },
+            "RedeemPointRewardResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "redeemed": {
+                        "type": "boolean"
+                    },
+                    "pointsUsed": {
+                        "type": "number"
+                    },
+                    "remainingPoints": {
+                        "type": "number"
+                    }
+                },
+                "required": [
+                    "message",
+                    "pointsUsed",
+                    "redeemed",
+                    "remainingPoints"
+                ]
+            },
+            "RedeemVisitRewardResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "redeemed": {
+                        "type": "boolean"
+                    }
+                },
+                "required": [
+                    "message",
+                    "redeemed"
+                ]
+            },
+            "Reward": {
+                "type": "object",
+                "properties": {
+                    "reward_id": {
+                        "type": "string"
+                    },
+                    "id": {
+                        "type": "string"
+                    }
+                }
+            },
+            "RewardPlan": {
+                "type": "object",
+                "properties": {
+                    "visits": {
+                        "$ref": "#/components/schemas/VisitRewardProps"
+                    },
+                    "points": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/PointsRewardOption"
+                        }
+                    }
+                }
+            },
+            "RuntimeErrorResponseContent": {
+                "type": "object",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    }
+                }
+            },
+            "SearchShopsPublicResponseContent": {
+                "type": "object",
+                "description": "Output for NearbyShops, FavoriteShops, PopularShops, RadiusShops",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/EnrichedShop"
+                        }
+                    },
+                    "count": {
+                        "type": "number"
+                    },
+                    "pagination": {
+                        "$ref": "#/components/schemas/PaginationInfo"
+                    }
+                }
+            },
+            "SearchSuggestionItem": {
+                "type": "object",
+                "description": "Search suggestion result structure",
+                "properties": {
+                    "shop_id": {
+                        "type": "string"
+                    },
+                    "organization_id": {
+                        "type": "string"
+                    },
+                    "search_name": {
+                        "type": "string"
+                    },
+                    "favorite": {
+                        "type": "boolean"
+                    },
+                    "distance": {
+                        "type": "number",
+                        "format": "double"
+                    }
+                },
+                "required": [
+                    "distance",
+                    "favorite",
+                    "organization_id",
+                    "search_name",
+                    "shop_id"
+                ]
+            },
+            "SearchSuggestionResponseContent": {
+                "type": "object",
+                "description": "Output for SearchSuggestion - returns SearchSuggestionList\nHandler should return { value: SearchSuggestionList } where value is the array",
+                "properties": {
+                    "value": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/SearchSuggestionItem"
+                        }
+                    }
+                }
+            },
+            "ShopHoursItem": {
+                "type": "object",
+                "description": "Individual shop hours entry for a day",
+                "properties": {
+                    "day": {
+                        "type": "string"
+                    },
+                    "open": {
+                        "type": "string"
+                    },
+                    "close": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "close",
+                    "day",
+                    "open"
+                ]
+            },
+            "ShopLocation": {
+                "type": "object",
+                "description": "Simple shop structure with just coordinates",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "longitude": {
+                        "type": "number",
+                        "format": "double"
+                    },
+                    "latitude": {
+                        "type": "number",
+                        "format": "double"
+                    }
+                },
+                "required": [
+                    "id",
+                    "latitude",
+                    "longitude"
+                ]
+            },
+            "Tier": {
+                "type": "object",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "rewards": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "required": [
+                    "id",
+                    "rewards"
+                ]
+            },
+            "TierMap": {
+                "type": "object",
+                "additionalProperties": {
+                    "$ref": "#/components/schemas/Tier"
+                },
+                "propertyNames": {
+                    "type": "string"
+                }
+            },
+            "UpdateUserRequestContent": {
+                "type": "object",
+                "description": "Input for UpdateUser - body contains fullname fields",
+                "properties": {
+                    "fullname": {
+                        "$ref": "#/components/schemas/UserFullnameUpdate"
+                    }
+                }
+            },
+            "UpdateUserResponseContent": {
+                "type": "object",
+                "description": "Output for UpdateUser",
+                "properties": {
+                    "message": {
+                        "type": "string"
+                    },
+                    "user": {
+                        "$ref": "#/components/schemas/User"
+                    }
+                }
+            },
+            "User": {
+                "type": "object",
+                "description": "Full user object structure",
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "email": {
+                        "type": "string"
+                    },
+                    "birthdate": {
+                        "type": "string"
+                    },
+                    "fullname": {
+                        "$ref": "#/components/schemas/UserFullname"
+                    },
+                    "date_created": {
+                        "type": "string"
+                    },
+                    "newAccount": {
+                        "type": "boolean"
+                    },
+                    "preferences": {
+                        "$ref": "#/components/schemas/UserPreferences"
+                    },
+                    "total_visits": {
+                        "type": "number"
+                    },
+                    "total_points": {
+                        "type": "number"
+                    },
+                    "total_rewards": {
+                        "type": "number"
+                    },
+                    "fraud_count": {
+                        "type": "number"
+                    },
+                    "num_redeemableRewards": {
+                        "type": "number"
+                    }
+                },
+                "required": [
+                    "birthdate",
+                    "date_created",
+                    "email",
+                    "id",
+                    "newAccount",
+                    "preferences",
+                    "total_points",
+                    "total_rewards",
+                    "total_visits"
+                ]
+            },
+            "UserFullname": {
+                "type": "object",
+                "properties": {
+                    "firstName": {
+                        "type": "string"
+                    },
+                    "lastName": {
+                        "type": "string"
+                    }
+                }
+            },
+            "UserFullnameUpdate": {
+                "type": "object",
+                "description": "Partial fullname structure for updates (all fields optional)",
+                "properties": {
+                    "firstName": {
+                        "type": "string"
+                    },
+                    "lastName": {
+                        "type": "string"
+                    }
+                }
+            },
+            "UserPreferences": {
+                "type": "object",
+                "properties": {
+                    "lightMode": {
+                        "type": "boolean"
+                    }
+                }
+            },
+            "ValidationExceptionField": {
+                "type": "object",
+                "description": "Describes one specific validation failure for an input member.",
+                "properties": {
+                    "path": {
+                        "type": "string",
+                        "description": "A JSONPointer expression to the structure member whose value failed to satisfy the modeled constraints."
+                    },
+                    "message": {
+                        "type": "string",
+                        "description": "A detailed description of the validation failure."
+                    }
+                },
+                "required": [
+                    "message",
+                    "path"
+                ]
+            },
+            "ValidationExceptionResponseContent": {
+                "type": "object",
+                "description": "A standard error for input validation failures.\nThis should be thrown by services when a member of the input structure\nfalls outside of the modeled or documented constraints.",
+                "properties": {
+                    "message": {
+                        "type": "string",
+                        "description": "A summary of the validation failure."
+                    },
+                    "fieldList": {
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/components/schemas/ValidationExceptionField"
+                        },
+                        "description": "A list of specific failures encountered while validating the input.\nA member can appear in this list more than once if it failed to satisfy multiple constraints."
+                    }
+                },
+                "required": [
+                    "message"
+                ]
+            },
+            "VisitRewardProps": {
+                "type": "object",
+                "properties": {
+                    "tiers": {
+                        "$ref": "#/components/schemas/TierMap"
+                    },
+                    "min_spend": {
+                        "type": "number"
+                    }
+                },
+                "required": [
+                    "min_spend",
+                    "tiers"
+                ]
+            }
+        }
+    }
+}