diff --git a/app/controllers/api/database.php b/app/controllers/api/database.php
index f86200ab83..d863948287 100644
--- a/app/controllers/api/database.php
+++ b/app/controllers/api/database.php
@@ -373,8 +373,8 @@ App::get('/v1/database/collections/:collectionId/documents')
     ->label('sdk.description', '/docs/references/database/list-documents.md')
     ->param('collectionId', null, new UID(), 'Collection unique ID. You can create a new collection with validation rules using the Database service [server integration](/docs/server/database#createCollection).')
     ->param('filters', [], new ArrayList(new Text(128)), 'Array of filter strings. Each filter is constructed from a key name, comparison operator (=, !=, >, <, <=, >=) and a value. You can also use a dot (.) separator in attribute names to filter by child document attributes. Examples: \'name=John Doe\' or \'category.$id>=5bed2d152c362\'.', true)
-    ->param('limit', 25, new Range(0, 1000), 'Maximum number of documents to return in response.  Use this value to manage pagination.', true)
-    ->param('offset', 0, new Range(0, 900000000), 'Offset value. Use this value to manage pagination.', true)
+    ->param('limit', 25, new Range(0, 100), 'Maximum number of documents to return in response.  Use this value to manage pagination. By default will return maximum 25 results. Maximum of 100 results allowed per request.', true)
+    ->param('offset', 0, new Range(0, 900000000), 'Offset value. The default value is 0. Use this param to manage pagination.', true)
     ->param('orderField', '$id', new Text(128), 'Document field that results will be sorted by.', true)
     ->param('orderType', 'ASC', new WhiteList(['DESC', 'ASC'], true), 'Order direction. Possible values are DESC for descending order, or ASC for ascending order.', true)
     ->param('orderCast', 'string', new WhiteList(['int', 'string', 'date', 'time', 'datetime'], true), 'Order field type casting. Possible values are int, string, date, time or datetime. The database will attempt to cast the order field to the value you pass here. The default value is a string.', true)