diff --git a/doc/schemas/decode.request.json b/doc/schemas/decode.request.json
new file mode 100644
index 000000000..0dff816f2
--- /dev/null
+++ b/doc/schemas/decode.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "added": "v23.05",
+  "required": [
+    "string"
+  ],
+  "properties": {
+    "string": {
+      "type": "string"
+    }
+  }
+}
diff --git a/doc/schemas/decodepay.request.json b/doc/schemas/decodepay.request.json
new file mode 100644
index 000000000..d4e5ae4d3
--- /dev/null
+++ b/doc/schemas/decodepay.request.json
@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "added": "v23.05",
+  "required": [
+    "bolt11"
+  ],
+  "properties": {
+    "bolt11": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    }
+  }
+}