diff --git a/README.md b/README.md
index 57e5c81..135b8c5 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,13 @@
 Qakka was developed as for this JIRA Issue: [USERGRID-1318](https://issues.apache.org/jira/browse/USERGRID-1318).
 
 
+## How to use Qakka
+
+We don't have any examples of Qakka REST API use yet, but we do have Swagger generated docs:
+
+* [Qakka REST API docs](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/apache/usergrid-qakka/master/docs/swagger.json)
+
+
 ## How to build Qakka
 
 Qakka is unreleased software and if you want to use it, you will have to built it. Here are the steps to build Qakka: