From 7b3612f33ad74b7c4804189e3c94218578335377 Mon Sep 17 00:00:00 2001
From: Cody Reichert <cody@reichertbrothers.com>
Date: Thu, 3 Feb 2022 12:56:53 -0600
Subject: [PATCH 1/2] Add docs for salesOffice query parameter

---
 api/simplyrets-openapi.yaml | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/api/simplyrets-openapi.yaml b/api/simplyrets-openapi.yaml
index 51e7993..59cd0fc 100644
--- a/api/simplyrets-openapi.yaml
+++ b/api/simplyrets-openapi.yaml
@@ -476,8 +476,9 @@ paths:
       - "$ref": "#/components/parameters/subtype"
       - "$ref": "#/components/parameters/subTypeText"
       - "$ref": "#/components/parameters/agent"
-      - "$ref": "#/components/parameters/salesAgent"
       - "$ref": "#/components/parameters/brokers"
+      - "$ref": "#/components/parameters/salesAgent"
+      - "$ref": "#/components/parameters/salesOffice"
       - "$ref": "#/components/parameters/specialListingConditions"
       - "$ref": "#/components/parameters/ownership"
       - "$ref": "#/components/parameters/minprice"
@@ -1267,6 +1268,21 @@ components:
         type: array
         items:
           type: string
+    brokers:
+      required: false
+      in: query
+      name: brokers
+      description: |
+        Filter the listings returned by brokerage with a Broker
+        ID. For some MLS areas, this is the ListOfficeId (Listing
+        Office ID).  You can specific multiple broker
+        parameters. Note, this query parameter is only available
+        if a Broker ID is provided by your RETS vendor or MLS.
+      explode: true
+      schema:
+        type: array
+        items:
+          type: string
     salesAgent:
       required: false
       in: query
@@ -1284,16 +1300,15 @@ components:
         type: array
         items:
           type: string
-    brokers:
+    salesOffice:
       required: false
       in: query
-      name: brokers
+      name: salesOffice
       description: |
-        Filter the listings returned by brokerage with a Broker
-        ID. For some MLS areas, this is the ListOfficeId (Listing
-        Office ID).  You can specific multiple broker
-        parameters. Note, this query parameter is only available
-        if a Broker ID is provided by your RETS vendor or MLS.
+        Filter the listings returned by the `sales.office.brokerid`
+        field. This parameter can be specified multiple times.
+
+        Note, Office MLS IDs are provided by your MLS or data vendor.
       explode: true
       schema:
         type: array

From 566efeb363898c02fcbc6ad936db7aca106eb3b4 Mon Sep 17 00:00:00 2001
From: Cody Reichert <cody@reichertbrothers.com>
Date: Thu, 2 Jun 2022 17:53:02 -0500
Subject: [PATCH 2/2] Clarify description of `brokers` parameter

---
 api/simplyrets-openapi.yaml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/api/simplyrets-openapi.yaml b/api/simplyrets-openapi.yaml
index 59cd0fc..69e1b61 100644
--- a/api/simplyrets-openapi.yaml
+++ b/api/simplyrets-openapi.yaml
@@ -1273,11 +1273,13 @@ components:
       in: query
       name: brokers
       description: |
-        Filter the listings returned by brokerage with a Broker
-        ID. For some MLS areas, this is the ListOfficeId (Listing
-        Office ID).  You can specific multiple broker
-        parameters. Note, this query parameter is only available
-        if a Broker ID is provided by your RETS vendor or MLS.
+        Filter the listings by returned by ListOfficeMlsId
+        (`.office.brokerid`).  For most MLS areas, this will
+        correspond to the "Office MLS ID".  You can specify
+        multiple `broker` parameters per query.
+
+        Note: your data feed must contain a ListOfficeMlsId or similar
+        field for this filter to work.
       explode: true
       schema:
         type: array