diff --git a/docs/spec-explained/parameters.md b/docs/spec-explained/parameters.md
index 3f8d7354..7452c583 100644
--- a/docs/spec-explained/parameters.md
+++ b/docs/spec-explained/parameters.md
@@ -117,6 +117,22 @@ paths:
           required: true
 ```
 
+Or, you would get all headers within a map as follows:
+
+```
+paths:
+  /ping:
+    get:
+      summary: Checks if the server is alive.
+      parameters:
+        - in: header
+          name: headers
+          schema:
+            type: object
+            additionalProperties:
+              type: string
+```
+
 In a similar way, you can define [custom response headers](#header-parameters).
 
 **Note:** Swagger specification has special keywords for some headers: