# Simple queries These functions implement the [HTTP API for simple queries](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html). ## collection.all `async collection.all([opts]): Cursor` Performs a query to fetch all documents in the collection. Returns a [new _Cursor_ instance](../Cursor.md) for the query results. **Arguments** * **opts**: `Object` (optional) For information on the possible options see [the HTTP API for returning all documents](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html#return-all-documents). ## collection.any `async collection.any(): Object` Fetches a document from the collection at random. ## collection.byExample `async collection.byExample(example, [opts]): Cursor` Performs a query to fetch all documents in the collection matching the given _example_. Returns a [new _Cursor_ instance](../Cursor.md) for the query results. **Arguments** * **example**: _Object_ An object representing an example for documents to be matched against. * **opts**: _Object_ (optional) For information on the possible options see [the HTTP API for fetching documents by example](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html#find-documents-matching-an-example). ## collection.firstExample `async collection.firstExample(example): Object` Fetches the first document in the collection matching the given _example_. **Arguments** * **example**: _Object_ An object representing an example for documents to be matched against. ## collection.removeByExample `async collection.removeByExample(example, [opts]): Object` Removes all documents in the collection matching the given _example_. **Arguments** * **example**: _Object_ An object representing an example for documents to be matched against. * **opts**: _Object_ (optional) For information on the possible options see [the HTTP API for removing documents by example](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html#remove-documents-by-example). ## collection.replaceByExample `async collection.replaceByExample(example, newValue, [opts]): Object` Replaces all documents in the collection matching the given _example_ with the given _newValue_. **Arguments** * **example**: _Object_ An object representing an example for documents to be matched against. * **newValue**: _Object_ The new value to replace matching documents with. * **opts**: _Object_ (optional) For information on the possible options see [the HTTP API for replacing documents by example](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html#replace-documents-by-example). ## collection.updateByExample `async collection.updateByExample(example, newValue, [opts]): Object` Updates (patches) all documents in the collection matching the given _example_ with the given _newValue_. **Arguments** * **example**: _Object_ An object representing an example for documents to be matched against. * **newValue**: _Object_ The new value to update matching documents with. * **opts**: _Object_ (optional) For information on the possible options see [the HTTP API for updating documents by example](https://docs.arangodb.com/latest/HTTP/SimpleQuery/index.html#update-documents-by-example). ## collection.lookupByKeys `async collection.lookupByKeys(keys): Array