Sentry Answers>FastAPI>

Exclude one or more fields in Pydantic model from appearing in FastAPI responses

Exclude one or more fields in Pydantic model from appearing in FastAPI responses

David Y.

—

The Problem

Some of the Pydantic models in my FastAPI project include secret internal fields that I don’t want to expose in the API response or generated documentation. For example, I would like to exclude the fields address and created_at in the User model below:

Click to Copy
from pydantic import BaseModel
from datetime import datetime

class User(BaseModel):
    username: str
    email: str
    address: str
    created_at: datetime

How do I keep these fields from appearing in responses while keeping them in the model?

The Solution

To exclude multiple fields from a Pydantic model, we can expand the type definition using Annotated from Python’s built-in typing module. This special typing form was proposed in PEP 593 and is used to add specific metadata to type declarations. This metadata is being used by libraries such as Pydantic to enable special behavior. In this case, we’ll use it to exclude the address and created_at fields from our API’s responses:

Click to Copy
from pydantic import BaseModel, Field # also import Field
from datetime import datetime
from typing import Annotated # import Annotated

class User(BaseModel):
    username: str
    email: str
    address: Annotated[str, Field(exclude=True)]
    created_at: Annotated[datetime, Field(exclude=True)]

Note that all of Pydantic’s standard validation features will still work for excluded fields.

  • Syntax.fmListen to the Syntax Podcast
  • Community SeriesIdentify, Trace, and Fix Endpoint Regression Issues
  • ResourcesBackend Error Monitoring 101
  • Syntax.fm logo
    Listen to the Syntax Podcast

    Tasty treats for web developers brought to you by Sentry. Get tips and tricks from Wes Bos and Scott Tolinski.

    SEE EPISODES

Considered “not bad” by 4 million developers and more than 100,000 organizations worldwide, Sentry provides code-level observability to many of the world’s best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

learn more about sentryjoin our discord
© 2025 • Sentry is a registered Trademark of Functional Software, Inc.