diff --git a/doc/api/projects.md b/doc/api/projects.md
index d37d3acf..16521917 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -57,6 +57,11 @@ GET /projects
 ]
 ```
 
+Return values:
+
++ `200 Ok` on success and a list of projects
++ `401 Unauthorized` if the user is not allowed to access projects
+
 
 ### Get single project
 
diff --git a/doc/api/users.md b/doc/api/users.md
index b94d7c0f..e5893638 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -43,6 +43,12 @@ GET /users
 ]
 ```
 
+Return values:
+
++ `200 Ok` on success and a list with all users
++ `401 Unauthorized` if user is not allowed to access the list
+
+
 ## Single user
 
 Get a single user.
@@ -74,6 +80,13 @@ Parameters:
 }
 ```
 
+Return values:
+
++ `200 Ok` on success and the user entry
++ `401 Unauthorized` if it is not allowed to access the user
++ `404 Not Found` if the user with ID is not found
+
+
 ## User creation
 Create user. Available only for admin