First Check

• I added a very descriptive title here.
• I used the GitHub search to find a similar question and didn't find it.
• I searched the FastAPI documentation, with the integrated search.
• I already searched in Google "How to X in FastAPI" and didn't find any information.
• I already read and followed all the tutorial in the docs and didn't find an answer.
• I already checked if it is not related to FastAPI but to Pydantic.
• I already checked if it is not related to FastAPI but to Swagger UI.
• I already checked if it is not related to FastAPI but to ReDoc.

Commit to Help

• I commit to help with one of those options 👆

Example Code

from typing import Annotated, Literal

from fastapi import FastAPI, Query
from pydantic import BaseModel, Field

app = FastAPI()


class FilterParams(BaseModel):
    limit: int = Field(100, gt=0, le=100)
    offset: int = Field(0, ge=0)
    order_by: Literal["created_at", "updated_at"] = "created_at"
    tags: list[str] = []


class MoreParams(BaseModel):
    extra_param: str = Field(
        ...,
        description="An extra parameter",
    )
    another_param: str = Field(
        None,
        alias="identifier",
        description="Another Parameter",
    )

@app.get("/items/")
async def read_items(
        filter_params: Annotated[FilterParams, Query()],
        more_params: Annotated[MoreParams, Query()]
    ) -> str:
        return "NA"

Description

I'm having trouble getting multiple query parameter objects to work using the method described in the docs.
When I try the example code included in this post the OpenAPI docs look like this:

I've had this working in past versions of FastAPI using Depends() like this:

from typing import Literal

from fastapi import Depends, FastAPI
from pydantic import BaseModel, Field

app = FastAPI()


class FilterParams(BaseModel):
    limit: int = Field(100, gt=0, le=100)
    offset: int = Field(0, ge=0)
    order_by: Literal["created_at", "updated_at"] = "created_at"
    tags: list[str] = []


class MoreParams(BaseModel):
    extra_param: str = Field(
        ...,
        description="An extra parameter",
    )
    another_param: str = Field(
        None,
        alias="identifier",
        description="Another Parameter",
    )

@app.get("/items/")
async def read_items(
        filter_params: FilterParams = Depends(),
        more_params: MoreParams = Depends()
    ) -> str:
        return "NA"

However, this doesn't seem to work correctly. Note that the "tags" parameter is missing from the docs.

I'm not sure what I'm doing wrong here and to be honest I am not understanding the difference in semantics between using Query() and using Depends().

Any help will be much appreciated. Thank you.

Operating System

Linux

Operating System Details

No response

FastAPI Version

0.115.7

Pydantic Version

2.10.6

Python Version

3.12.6

Additional Context

No response