Update API documentation

Update the Pagination section of the API documentation.

Partially fixes bug 1202748

Change-Id: Iec0e6ba47152cef77a30a3464d98516356e04ca4