openapi-schema-validator

OpenAPI schema validation for Python

openapi-schema-validator Permissive license BSD-3-Clause Active ★ 126 v0.9.0 released 2026-04-27

Install

openapi-schema-validator on PyPI

pip

pip install openapi-schema-validator

uv

uv add openapi-schema-validator

poetry

poetry add openapi-schema-validator

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (<4.0.0,>=3.10.0)
Install friction	low — pure-Python wheel
Runtime dependencies	6 — jsonschema, jsonschema-specifications, pydantic, pydantic-settings, referencing, rfc3339-validator
Maintenance	actively maintained — 108 days since the last release
Last repo commit	2026-07-20
First released	2020-03-05
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: openapi_schema_validator-0.9.0-py3-none-any.whl

Keywords: openapi, swagger, schema

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed

About openapi-schema-validator

from the package's own PyPI description — quoted content, verbatim

openapi-schema-validator

.. image:: https://img.shields.io/pypi/v/openapi-schema-validator.svg :target: https://pypi.org/project/openapi-schema-validator/ .. image:: https://github.com/python-openapi/openapi-schema-validator/actions/workflows/python-tests.yml/badge.svg :target: https://github.com/python-openapi/openapi-schema-validator/actions .. image:: https://img.shields.io/codecov/c/github/python-openapi/openapi-schema-validator/master.svg?style=flat :target: https://codecov.io/github/python-openapi/openapi-schema-validator?branch=master .. image:: https://img.shields.io/pypi/pyversions/openapi-schema-validator.svg :target: https://pypi.org/project/openapi-schema-validator/ .. image:: https://img.shields.io/pypi/format/openapi-schema-validator.svg :target: https://pypi.org/project/openapi-schema-validator/ .. image:: https://img.shields.io/pypi/status/openapi-schema-validator.svg :target: https://pypi.org/project/openapi-schema-validator/

About

openapi-schema-validator is a Python library that validates schemas against:

`OpenAPI Schema Specification v3.0...

Read as markdown · JSON record · Source repository

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Validates data against OpenAPI schema specifications (3.0, 3.1, and 3.2) using jsonschema under the hood, with support for multiple validator classes and configurable reference resolution.

Low friction: pure Python wheel with six stable runtime dependencies (jsonschema, pydantic, referencing, and format validators). Actively maintained as of April 2026 with recent commits.

BSD-3-Clause permissive license allows commercial use, modification, and distribution with minimal restrictions—suitable for most projects.

Usage

pip install openapi-schema-validator

from openapi_schema_validator import validate

schema = {"type": "object", "properties": {"name": {"type": "string"}}}
validate({"name": "John"}, schema)

Requires Python 3.10 or later (supports up to 3.14).

Verdict: A well-maintained, low-friction validator for OpenAPI schemas across all three major versions. No known vulnerabilities, permissive licensing, and active development make it a solid choice for API contract testing and validation workflows.

Needs verification

Performance characteristics under high-volume validation or with very large schemas
Compatibility with custom jsonschema validators or extensions beyond those documented

openapi schema validationvalidate openapi specsjson schema validator openapiopenapi 3.0 3.1 3.2 validatorapi schema validation pythonswagger schema validatoropenapi compliance checking