diff --git a/doc/api/users.md b/doc/api/users.md
index 4098da72b30..1b9eecf2159 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -51,6 +51,10 @@ GET /users
 ]
 ```
 
+You can search for a users by email or username with:
+`/users?search=John`
+
+Also see `def search query` in `app/models/user.rb`.
 
 ## Single user