How to extract some links is a single request

[YedidyaHKfir]

Hi, I’m trying to use Beanie as my MongoDB client.

My data model includes multiple relations, and I’d like to selectively eager-load certain related documents when querying—based on my own logic.

Here’s a simplified example of my setup:

from beanie import init_beanie, Document, Link

class BasicModel(Document):
    name: str
    last_name: str

class AdditionalData(Document):
    additional_info: str
    extra_data: str

class NestedModel(Document):
    basic: Link[BasicModel]
    data: Link[AdditionalData]
    data2: Link[AdditionalData]
    age: int

According to the documentation, I can fetch linked documents like this:

nested = await NestedModel.get(id)
await nested.fetch_link(NestedModel.data)
await nested.fetch_link(NestedModel.data2)

But this results in multiple round trips to the database.

My Question:

Is there a way to eager-load specific linked fields (like data and data2) in a single query?
If so, how should I structure that call? If not, is such a feature planned or recommended?

Thanks!