diff --git a/docs/db-api.txt b/docs/db-api.txt index 405ed87cef7e3..a15c45d37b569 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -1061,7 +1061,12 @@ they query the database each time they're called. Returns the object matching the given lookup parameters, which should be in the format described in `Field lookups`_. -``get()`` raises ``AssertionError`` if more than one object was found. +``get()`` raises ``MultipleObjectsReturned`` if more than one object was found. +The ``MultipleObjectsReturned`` exception is an attribute of the model class. +For example, the following will raise ``MultipleObjectsReturned`` if there +are more than one authors with the name of 'John':: + + Author.objects.get(name='John') # raises Author.MultipleObjectsReturned ``get()`` raises a ``DoesNotExist`` exception if an object wasn't found for the given parameters. The ``DoesNotExist`` exception is an attribute of the model