diff --git a/Gemfile.lock b/Gemfile.lock
index f38e06c408..e3cc9ee2e4 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -520,7 +520,7 @@ GEM
       bundler (>= 1.3.0, < 2.0)
       railties (= 4.2.11.3)
       sprockets-rails
-    rails-deprecated_sanitizer (1.0.3)
+    rails-deprecated_sanitizer (1.0.4)
       activesupport (>= 4.2.0.alpha)
     rails-dom-testing (1.0.9)
       activesupport (>= 4.2.0, < 5.0)
@@ -598,17 +598,17 @@ GEM
     rspec-retry (0.6.2)
       rspec-core (> 3.3)
     rspec-support (3.10.1)
-    rswag (2.3.3)
-      rswag-api (= 2.3.3)
-      rswag-specs (= 2.3.3)
-      rswag-ui (= 2.3.3)
-    rswag-api (2.3.3)
+    rswag (2.4.0)
+      rswag-api (= 2.4.0)
+      rswag-specs (= 2.4.0)
+      rswag-ui (= 2.4.0)
+    rswag-api (2.4.0)
       railties (>= 3.1, < 7.0)
-    rswag-specs (2.3.3)
+    rswag-specs (2.4.0)
       activesupport (>= 3.1, < 7.0)
       json-schema (~> 2.2)
       railties (>= 3.1, < 7.0)
-    rswag-ui (2.3.3)
+    rswag-ui (2.4.0)
       actionpack (>= 3.1, < 7.0)
       railties (>= 3.1, < 7.0)
     rubocop (1.10.0)
diff --git a/swagger/v1/swagger.yaml b/swagger/v1/swagger.yaml
index 88d54ed960..5898f1521e 100644
--- a/swagger/v1/swagger.yaml
+++ b/swagger/v1/swagger.yaml
@@ -76,43 +76,51 @@ paths:
       parameters:
       - name: X-Spree-Token
         in: header
-        type: string
+        schema:
+          type: string
       - name: q[distributor_id_eq]
         in: query
-        type: string
         required: false
         description: Query orders for a specific distributor id.
+        schema:
+          type: string
       - name: q[completed_at_gt]
         in: query
-        type: string
         required: false
         description: Query orders completed after a date.
+        schema:
+          type: string
       - name: q[completed_at_lt]
         in: query
-        type: string
         required: false
         description: Query orders completed before a date.
+        schema:
+          type: string
       - name: q[state_eq]
         in: query
-        type: string
         required: false
         description: Query orders by order state, eg 'cart', 'complete'.
+        schema:
+          type: string
       - name: q[payment_state_eq]
         in: query
-        type: string
         required: false
         description: Query orders by order payment_state, eg 'balance_due', 'paid',
           'failed'.
+        schema:
+          type: string
       - name: q[email_cont]
         in: query
-        type: string
         required: false
         description: Query orders where the order email contains a string.
+        schema:
+          type: string
       - name: q[order_cycle_id_eq]
         in: query
-        type: string
         required: false
         description: Query orders for a specific order_cycle id.
+        schema:
+          type: string
       responses:
         '200':
           description: get orders