How to Use get in Django ORM: Syntax and Examples

Use Model.objects.get() to retrieve a single object matching the given filter in Django ORM. It raises DoesNotExist if no match is found and MultipleObjectsReturned if more than one match exists.

Syntax

The get() method is called on a model's manager, usually objects. It takes keyword arguments to filter the query and returns exactly one object.

• Model: Your Django model class.
• objects: The default manager to query the database.
• get(): Method to fetch a single record matching the filters.
• kwargs: Field lookups as keyword arguments to filter the query.

python

Model.objects.get(field1=value1, field2=value2)

Example

This example shows how to get a single Book object by its id. It demonstrates retrieving the object and handling the case when it does not exist.

python

from django.core.exceptions import ObjectDoesNotExist

# Assume a Book model with fields: id, title, author

try:
    book = Book.objects.get(id=1)
    print(f"Book title: {book.title}")
except Book.DoesNotExist:
    print("No book found with id=1")

Output

Book title: The Great Gatsby

Common Pitfalls

Common mistakes when using get() include:

• Expecting get() to return multiple objects; it only returns one and raises MultipleObjectsReturned if more than one match exists.
• Not handling the DoesNotExist exception when no object matches the query.
• Using filters that are not unique, causing errors.

Always use try-except blocks to catch exceptions when using get().

python

try:
    user = User.objects.get(username='john')  # May raise exceptions
except User.DoesNotExist:
    print('User not found')
except User.MultipleObjectsReturned:
    print('Multiple users found with username john')

Quick Reference

Method	Description
get()	Returns a single object matching the filters or raises exceptions
DoesNotExist	Exception raised if no object matches the query
MultipleObjectsReturned	Exception raised if more than one object matches
filter()	Use to get multiple objects instead of get()

Key Takeaways

Use Model.objects.get() to fetch exactly one object matching your filters.

Always handle DoesNotExist and MultipleObjectsReturned exceptions when using get().

get() returns a single object; use filter() for multiple results.

Use unique fields or combinations to avoid MultipleObjectsReturned errors.

Wrap get() calls in try-except blocks to handle missing or multiple records gracefully.