diff --git a/docs/source/rest.md b/docs/source/rest.md
index 827a74c6..3ef7c659 100644
--- a/docs/source/rest.md
+++ b/docs/source/rest.md
@@ -49,8 +49,9 @@ Authorization header.
 ### Use requests
 
 Using the popular Python [requests](http://docs.python-requests.org/en/master/)
-library, here's example code to get users of a JupyterHub deployment. An API
-is made, and the request sends an API token for authorization:
+library, here's example code to make an API request for the users of a JupyterHub
+deployment. An API GET request is made, and the request sends an API token for
+authorization. The response contains information about the users:
 
 ```python
 import requests