diff --git a/README.md b/README.md
index b21d076..07db75b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
-API endpoints:
+# API endpoints:
 
-```/mocha/users/{user_id}```
+| Endpoint                 | Return                  |
+| ------------------------ | ----------------------- |
+| `/mocha/users/{user_id}` | row with the given user |
+| `/mocha/users/*`         | all rows                |