Document pool query parameter / fix field name

api/simplyrets-openapi.yaml

@@ -502,6 +502,7 @@ paths:
       - "$ref": "#/components/parameters/postalCodes"
       - "$ref": "#/components/parameters/features"
       - "$ref": "#/components/parameters/exteriorFeatures"
+      - "$ref": "#/components/parameters/pool"
       - "$ref": "#/components/parameters/water"
       - "$ref": "#/components/parameters/neighborhoods"
       - "$ref": "#/components/parameters/cities"
@@ -986,6 +987,7 @@ paths:
       - "$ref": "#/components/parameters/postalCodes"
       - "$ref": "#/components/parameters/features"
       - "$ref": "#/components/parameters/exteriorFeatures"
+      - "$ref": "#/components/parameters/pool"
       - "$ref": "#/components/parameters/water"
       - "$ref": "#/components/parameters/neighborhoods"
       - "$ref": "#/components/parameters/cities"
@@ -1576,6 +1578,27 @@ components:
         type: array
         items:
           type: string
+    pool:
+      required: false
+      in: query
+      name: pool
+      description: >
+        Filter listings on pool features (`.property.pool`). There
+        are multiple ways to use this parameter:
+
+        - `pool=true`: Return listings where `.property.water` is NOT
+          `false` or `null`.
+        - `pool=false`: Return listings where `.property.water` IS
+          `false` or `null`.
+        - `pool=QUERY`: Return listings with a matching
+          `.property.pool` value. Example: `?pool=Private`.
+
+        If this parameter is used multiple times in a single query,
+        return listings that match any of the provided values.
+      schema:
+        type: array
+        items:
+          type: string
     water:
       required: false
       in: query
@@ -1991,7 +2014,7 @@ components:
         foundation:
           type: string
           nullable: true
-        poolFeatures:
+        pool:
           type: string
           nullable: true
         laundryFeatures: