Find Documents
This page describes how to select or query for documents in a collection.
db.collection.find()
The find() method returns a cursor to the documents that match the query criteria.
Syntax
db.collection.find(query, projection, options)
Parameters
- query
- Optional. Specifies selection filter using query operators.
- projection
- Optional. Specifies the fields to return in the documents that match the query filter.
- options
- Optional. Additional options for the query.
Examples
Select all documents
db.inventory.find({})
Specify equality condition
db.inventory.find({ status: "D" })
Specify conditions using query operators
db.inventory.find({ status: { $in: [ "A", "D" ] } })
Important
Starting in MongoDB 4.4, you can specify a projection expression as a field argument to the find() method.
For more information, see Query Documents.