Flask-Pydantic

What it is and what it does

Flask-Pydantic is a Flask extension that bridges Flask request handling with Pydantic's validation framework. It provides a `@validate()` decorator that intercepts incoming HTTP requests, extracts parameters from query strings, request bodies, form data, and URL paths, validates them against Pydantic models, and makes the validated data available to your route handler either through function arguments or via Flask's request object.

The decorator automatically returns a 400 response with detailed validation errors if any parameter fails validation. It supports customizing success status codes, handling multiple models in responses or request bodies, and leverages Pydantic's alias feature for field name mapping. The package depends on Flask, Pydantic, and typing_extensions, making it a lightweight addition to existing Flask applications that already use Pydantic.

Use it for

• Validate incoming JSON request bodies against Pydantic models before processing in POST/PUT endpoints
• Enforce type checking and required fields on query parameters without manual parsing or try-catch blocks
• Parse and validate URL path parameters (e.g., `/users/<user_id>`) as typed integers or other Pydantic-supported types
• Combine validation of query, body, and form data in a single route handler with clear type hints
• Automatically serialize Pydantic model instances back to JSON responses with optional field aliasing

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

flask-pydantic on PyPI

Before you install

Low friction install with three straightforward runtime dependencies. Maintenance status is aging—last release was 235 days ago—but the repository remains active and part of the Pallets Community Ecosystem, which provides organizational backing for Flask extensions.

Requires Python 3.7 or later; Flask and Pydantic must be installed as runtime dependencies.

License in practice

Licensed under the MIT License (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install Flask-Pydantic

from flask import Flask
from pydantic import BaseModel
from flask_pydantic import validate

app = Flask(__name__)

class QueryModel(BaseModel):
    age: int

@app.route('/', methods=['GET'])
@validate()
def get(query: QueryModel):
    return {'age': query.age}

Package facts

Evidence: flask_pydantic-0.14.0-py3-none-any.whl

Tags

More Python Modules packages

See also flask-pydantic-spec · flask-openapi3 · pydantic-handlebars · APIFlask · drf-pydantic · pydantic-partial · bump-pydantic · pydantic_core · Flask-WTF · Flask-Caching