diff --git a/schema/ack.get.request.json b/schema/ack.get.request.json
new file mode 100644
index 0000000..8ff43b2
--- /dev/null
+++ b/schema/ack.get.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "blinded_utxo"
+  ],
+  "properties": {
+    "blinded_utxo": {
+      "type": "string",
+      "description": "The blinded UTXO for which we want to know ACK status."
+    }
+  }
+}
diff --git a/schema/ack.get.schema.json b/schema/ack.get.schema.json
new file mode 100644
index 0000000..49632d7
--- /dev/null
+++ b/schema/ack.get.schema.json
@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+  ],
+  "properties": {
+    "result": {
+      "type": "boolean",
+      "description": "`true` when counterparty ACKed before, `false` if they NACKed, `null` if they haven't given any response yet."
+    }
+  }
+}
diff --git a/schema/ack.post.request.json b/schema/ack.post.request.json
new file mode 100644
index 0000000..f503f9c
--- /dev/null
+++ b/schema/ack.post.request.json
@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "blinded_utxo",
+    "ack"
+  ],
+  "properties": {
+    "blinded_utxo": {
+      "type": "string",
+      "description": "The blinded UTXO for which we want to ACK or nACK its associated consignment file"
+    },
+    "ack": {
+      "type": "boolean",
+      "description": "Whether the consignment is accepted (`true`) or rejected (`false`)"
+    }
+  }
+}
diff --git a/schema/ack.post.schema.json b/schema/ack.post.schema.json
new file mode 100644
index 0000000..73b721a
--- /dev/null
+++ b/schema/ack.post.schema.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "result"
+  ],
+  "properties": {
+    "result": {
+      "type": "boolean",
+      "description": "`true` when first successful upload. `false` when the same request has been made before."
+    }
+  }
+}
diff --git a/schema/consignment.get.request.json b/schema/consignment.get.request.json
new file mode 100644
index 0000000..b3fd523
--- /dev/null
+++ b/schema/consignment.get.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "blinded_utxo"
+  ],
+  "properties": {
+    "blinded_utxo": {
+      "type": "string",
+      "description": "the blinded UTXO for which we want to download consignment data"
+    }
+  }
+}
diff --git a/schema/consignment.get.schema.json b/schema/consignment.get.schema.json
new file mode 100644
index 0000000..2ee9dac
--- /dev/null
+++ b/schema/consignment.get.schema.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "result"
+  ],
+  "properties": {
+    "result": {
+      "type": "string",
+      "description": "`true` when first successful upload. `false` when the same file was already uploaded before."
+    }
+  }
+}
diff --git a/schema/consignment.post.request.json b/schema/consignment.post.request.json
new file mode 100644
index 0000000..c1711ce
--- /dev/null
+++ b/schema/consignment.post.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "blinded_utxo"
+  ],
+  "properties": {
+    "blinded_utxo": {
+      "type": "string",
+      "description": "the blinded UTXO for which we want to upload consingment file"
+    }
+  }
+}
diff --git a/schema/consignment.post.schema.json b/schema/consignment.post.schema.json
new file mode 100644
index 0000000..4e0538e
--- /dev/null
+++ b/schema/consignment.post.schema.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "result"
+  ],
+  "properties": {
+    "result": {
+      "type": "boolean",
+      "description": "`true` when first successful upload. `false` when the same file was already uploaded before."
+    }
+  }
+}
diff --git a/schema/media.get.request.json b/schema/media.get.request.json
new file mode 100644
index 0000000..d8e1dd2
--- /dev/null
+++ b/schema/media.get.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "attachment_id"
+  ],
+  "properties": {
+    "attachment_id": {
+      "type": "string",
+      "description": "Attachment id for which we want to upload a media file"
+    }
+  }
+}
diff --git a/schema/media.get.schema.json b/schema/media.get.schema.json
new file mode 100644
index 0000000..e47fe46
--- /dev/null
+++ b/schema/media.get.schema.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "result"
+  ],
+  "properties": {
+    "result": {
+      "type": "string",
+      "description": "base64 encoded media, if available."
+    }
+  }
+}
diff --git a/schema/media.post.request.json b/schema/media.post.request.json
new file mode 100644
index 0000000..d8e1dd2
--- /dev/null
+++ b/schema/media.post.request.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "attachment_id"
+  ],
+  "properties": {
+    "attachment_id": {
+      "type": "string",
+      "description": "Attachment id for which we want to upload a media file"
+    }
+  }
+}
diff --git a/schema/media.post.schema.json b/schema/media.post.schema.json
new file mode 100644
index 0000000..4e0538e
--- /dev/null
+++ b/schema/media.post.schema.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "result"
+  ],
+  "properties": {
+    "result": {
+      "type": "boolean",
+      "description": "`true` when first successful upload. `false` when the same file was already uploaded before."
+    }
+  }
+}
diff --git a/schema/openrpc.json b/schema/openrpc.json
new file mode 100644
index 0000000..3e93472
--- /dev/null
+++ b/schema/openrpc.json
@@ -0,0 +1,300 @@
+
+{
+  "openrpc": "1.2.4",
+  "info": {
+    "version": "0.1.0",
+    "title": "openrpc spec for rgb-proxy-server"
+  },
+  "servers": [
+    {
+      "name": "localhost",
+      "url": "http://localhost:3000/json-rpc"
+    }
+  ],
+  "methods": [
+    {
+      "name": "server.info",
+      "summary": "get server info",
+      "description": "get server info",
+      "params": [],
+      "result": {
+        "name": "server.info response",
+        "schema": {
+          "$ref": "server.info.schema.json"
+        }
+      }
+    },
+    {
+      "name": "consignment.post",
+      "summary": "Upload consignment info",
+      "description": "In addition to json-rpc request, the media file needs to be attached under \"file\" name via multipart form",
+      "params": [
+        {
+          "name": "consignment.post request",
+          "schema": {
+            "$ref": "consignment.post.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "consignment.post response",
+        "schema": {
+          "$ref": "consignment.post.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/CANNOT_CHANGE_ACK"
+        },
+        {
+          "$ref": "#/components/errors/INVALID_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_FILE"
+        }
+      ]
+    },
+    {
+      "name": "consignment.get",
+      "summary": "get previously uploaded consignment",
+      "params": [
+        {
+          "name": "consignment.get request",
+          "schema": {
+            "$ref": "consignment.get.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "consignment.get response",
+        "schema": {
+          "$ref": "consignment.get.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/INVALID_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/CONSIGNMENT_FILE_NOT_FOUND"
+        }
+      ]
+    },
+    {
+      "name": "media.post",
+      "summary": "Upload media file",
+      "description": "In addition to json-rpc request, the media file needs to be attached under \"file\" name via multipart form",
+      "params": [
+        {
+          "name": "media.post request",
+          "schema": {
+            "$ref": "media.post.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "media.post response",
+        "schema": {
+          "$ref": "media.post.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/CANNOT_CHANGE_FILES"
+        },
+        {
+          "$ref": "#/components/errors/INVALID_ATTACHMENT_ID"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_ATTACHMENT_ID"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_FILE"
+        }
+      ]
+    },
+    {
+      "name": "media.get",
+      "summary": "get media file in base64-encoded form",
+      "params": [
+        {
+          "name": "media.get request",
+          "schema": {
+            "$ref": "media.get.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "media.get response",
+        "schema": {
+          "$ref": "media.get.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/INVALID_ATTACHMENT_ID"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_ATTACHMENT_ID"
+        },
+        {
+          "$ref": "#/components/errors/MEDIA_FILE_NOT_FOUND"
+        }
+      ]
+    },
+    {
+      "name": "ack.post",
+      "summary": "Tell the server if specific consignment is accepted by the client (or not)",
+      "params": [
+        {
+          "name": "ack.post request",
+          "schema": {
+            "$ref": "ack.post.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "ack.post response",
+        "schema": {
+          "$ref": "ack.post.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/CANNOT_CHANGE_ACK"
+        },
+        {
+          "$ref": "#/components/errors/INVALID_ACK"
+        },
+        {
+          "$ref": "#/components/errors/INVALID_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_ACK"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/CONSIGNMENT_FILE_NOT_FOUND"
+        }
+      ]
+    },
+    {
+      "name": "ack.get",
+      "summary": "Check if the counterparty accepted the consignment or not",
+      "params": [
+        {
+          "name": "ack.get request",
+          "schema": {
+            "$ref": "ack.get.request.json"
+          }
+        }
+      ],
+      "result": {
+        "name": "ack.get response",
+        "schema": {
+          "$ref": "ack.get.schema.json"
+        }
+      },
+      "errors": [
+        {
+          "$ref": "#/components/errors/INVALID_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/MISSING_BLINDED_UTXO"
+        },
+        {
+          "$ref": "#/components/errors/CONSIGNMENT_FILE_NOT_FOUND"
+        }
+      ]
+    }
+  ],
+  "components": {
+    "errors": {
+      "CANNOT_CHANGE_ACK": {
+        "code": -100,
+        "message": "Cannot change ACK",
+        "data": {
+          "type": "object"
+        }
+      },
+      "CANNOT_CHANGE_FILES": {
+        "code": -101,
+        "message": "Cannot change uploaded files",
+        "data": {
+          "type": "object"
+        }
+      },
+      "INVALID_ACK": {
+        "code": -200,
+        "message": "Invalid ACK",
+        "data": {
+          "type": "object"
+        }
+      },
+      "INVALID_ATTACHMENT_ID": {
+        "code": -201,
+        "message": "Invalid ACK",
+        "data": {
+          "type": "object"
+        }
+      },
+      "INVALID_BLINDED_UTXO": {
+        "code": -202,
+        "message": "Invalid blinded utxo",
+        "data": {
+          "type": "object"
+        }
+      },
+      "MISSING_ACK": {
+        "code": -300,
+        "message": "Missing ACK",
+        "data": {
+          "type": "object"
+        }
+      },
+      "MISSING_ATTACHMENT_ID": {
+        "code": -301,
+        "message": "Missing attachment id",
+        "data": {
+          "type": "object"
+        }
+      },
+      "MISSING_BLINDED_UTXO": {
+        "code": -302,
+        "message": "Missing blinded utxo",
+        "data": {
+          "type": "object"
+        }
+      },
+      "MISSING_FILE": {
+        "code": -303,
+        "message": "Missing file",
+        "data": {
+          "type": "object"
+        }
+      },
+      "CONSIGNMENT_FILE_NOT_FOUND": {
+        "code": -400,
+        "message": "Consignment file not found",
+        "data": {
+          "type": "object"
+        }
+      },
+      "MEDIA_FILE_NOT_FOUND": {
+        "code": -401,
+        "message": "Media file not found",
+        "data": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/schema/server.info.schema.json b/schema/server.info.schema.json
new file mode 100644
index 0000000..cd38c6c
--- /dev/null
+++ b/schema/server.info.schema.json
@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol_version",
+    "version"
+  ],
+  "properties": {
+    "protocol_version": {
+      "type": "string",
+      "description": "version of the JSON-RPC protocol"
+    },
+    "version": {
+      "type": "string",
+      "description": "node software version"
+    },
+    "uptime": {
+      "type": "integer",
+      "description": "how long the server has been run (in seconds)."
+    }
+  }
+}