Docs Menu
Docs Home
/
Languages
/
Go
/
Go
/
Usage Examples
/
Find Operations

Find a Document

You can retrieve a single document from a collection by using the FindOne() method.

Example

Tip

Read the Usage Examples to learn how to run this example.

This example uses the following Restaurant struct as a model for documents in the restaurants collection:

type Restaurant struct {
	ID           primitive.ObjectID `bson:"_id"`
	Name         string
	RestaurantId string `bson:"restaurant_id"`
	Cuisine      string
	Address      interface{}
	Borough      string
	Grades       []interface{}
}

The following example matches documents in the restaurants collection in which the name is "Bagels N Buns", returning the first document matched:

coll := client.Database("sample_restaurants").Collection("restaurants")
filter := bson.D{{"name", "Bagels N Buns"}}
var result Restaurant
err = coll.FindOne(context.TODO(), filter).Decode(&result)
if err != nil {
	if err == mongo.ErrNoDocuments {
		// This error means your query did not match any documents.
		return
	}
	panic(err)
}

View a fully runnable example

Expected Result

Running the full example prints the following document, which is stored in the result variable as a Restaurant struct:

// results truncated
{
   "ID": "5eb3d668b31de5d588f42950",
   "Name": "Bagels N Buns",
   "RestaurantId": "40363427"
   "Address": [...],
   "Borough": "Staten Island",
   "Cuisine": "Delicatessen",
   "Grades": [...]
}

Additional Information

To learn more about specifying query filters and handling potential errors, see Retrieve Data.

To learn more about query operators, see the MongoDB query operator reference documentation.

API Documentation

FindOne()

Back

Find Operations

Next

Find Multiple Documents