diff --git a/README.md b/README.md
index fb47000..ff95852 100644
--- a/README.md
+++ b/README.md
@@ -24,10 +24,30 @@ In development, pre production.
 Verify whether the requesting app is authenticated. This is only
 allowed to be used for trusted appids.
 
+Returns a JSON object:
+
+Either
+```
+{
+    status: "OK",
+}
+```
+
+OR
+
+```
+{
+    status: "FAIL",
+}
+```
+
+
 ### POST: /verify
 
 Not sure if this one will be publicly available.
 
+Request JSON object:
+
 ```
 {
     version: "1",
@@ -38,6 +58,23 @@ Not sure if this one will be publicly available.
 }
 ```
 
+Response JSON object:
+
+Either
+```
+{
+    status: "OK",
+}
+```
+
+OR
+
+```
+{
+    status: "FAIL",
+}
+```
+
 ## Usage: REST
 
 - Use an existing token to connect to the service