diff --git a/routes/api.js b/routes/api.js
index d6bf3566..1e4fb70d 100644
--- a/routes/api.js
+++ b/routes/api.js
@@ -348,6 +348,37 @@ router.get('/subscriptions/:listId', (req, res) => {
     });
 });
 
+router.get('/lists', (req, res) => {
+    lists.quicklist((err, lists) => {
+        if (err) {
+            res.status(500);
+            return res.json({
+                error: err.message || err,
+                data: []
+            });
+        }
+        res.status(200);
+        res.json({
+            data: lists
+        });
+    });
+});
+
+router.get('/list/:id', (req, res) => {
+    lists.get(req.params.id, (err, list) => {
+        if (err) {
+            res.status(500);
+            return res.json({
+                error: err.message || err,
+            });
+        }
+        res.status(200);
+        res.json({
+            data: list
+        });
+    });
+});
+
 router.get('/lists/:email', (req, res) => {
     lists.getListsWithEmail(req.params.email, (err, lists) => {
         if (err) {
diff --git a/views/users/api.hbs b/views/users/api.hbs
index eaa0cb47..db51df39 100644
--- a/views/users/api.hbs
+++ b/views/users/api.hbs
@@ -296,3 +296,41 @@
 </p>
 
 <pre>curl -XGET '{{serviceUrl}}api/lists/test@example.com?access_token={{accessToken}} </pre>
+
+<h3>GET /api/lists – {{#translate}}Get all lists{{/translate}}</h3>
+
+<p>
+  {{#translate}}Retrieve every list. {{/translate}}
+</p>
+
+<p>
+  <strong>GET</strong> {{#translate}}arguments{{/translate}}
+</p>
+<ul>
+  <li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
+</ul>
+
+<p>
+  <strong>{{#translate}}Example{{/translate}}</strong>
+</p>
+
+<pre>curl -XGET '{{serviceUrl}}api/lists?access_token={{accessToken}}'</pre>
+
+<h3>GET /api/list/:id – {{#translate}}Get list by id{{/translate}}</h3>
+
+<p>
+  {{#translate}}Retrieve the list with :id {{/translate}}
+</p>
+
+<p>
+  <strong>GET</strong> {{#translate}}arguments{{/translate}}
+</p>
+<ul>
+  <li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
+</ul>
+
+<p>
+  <strong>{{#translate}}Example{{/translate}}</strong>
+</p>
+
+<pre>curl -XGET '{{serviceUrl}}api/list/1?access_token={{accessToken}}'</pre>
\ No newline at end of file