v1

latestOpenAPI 3.0.0BSD-3-Clause2026-07-146135105.7 KB
database

List Documents

Get a list of all the user documents. You can use the query params to filter your results. On admin mode, this endpoint will return a list of all of the project's documents. Learn more about different API modes.

get/database/collections/{collectionId}/documents

Path parameters

collectionIdstring required

Collection unique ID. You can create a new collection with validation rules using the Database service server integration.

Query parameters

filtersstring[]

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'.

limitinteger

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.

offsetinteger

Offset value. The default value is 0. Use this param to manage pagination.

orderFieldstring

Document field that results will be sorted by.

orderTypestring

Order direction. Possible values are DESC for descending order, or ASC for ascending order.

orderCaststring

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.

searchstring

Search query. Enter any free text search. The database will try to find a match against all document attributes and children. Max length: 256 chars.

Response

Documents List

suminteger required

Total sum of items in the list.