python-openapi/openapi-spec-validator

View on GitHub

OpenAPI Spec Validator is a CLI, pre-commit hook and python package that validates OpenAPI Specs against the OpenAPI 2.0 (aka Swagger), OpenAPI 3.0 and OpenAPI 3.1 specification.

Stars: 409
Forks: 73
Open beginner issues: 0
Indexed issues: 40

Dominant language: Python
License: Apache-2.0
Last GitHub push: May 20, 2026
Latest indexed: Sep 21, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

Unbounded cache in SpecValidator.iter_errors retains validator instances and schemas Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

python-openapi/openapi-spec-validator#523 · Opened Sep 8, 2026
Bug: internal library exception is leaked Open

Difficulty 3/5 1-2 days Newbie friendliness 55/100

python-openapi/openapi-spec-validator#511 · Opened Jun 9, 2026
version 0.7.2 is not compatible with open api version 0.19.4 Open

Difficulty 3/5 1-2 days Newbie friendliness 30/100

python-openapi/openapi-spec-validator#401 · Opened Jun 10, 2025
Possible Regression: RecursionError validating oneOf/allOf schema in 0.7.2 (works in 0.7.1) Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

python-openapi/openapi-spec-validator#400 · 1 comment · Opened Jun 10, 2025
Validation of required fields inconsistent Open

kind/bug/confirmed

Difficulty 5/5 Over a week Newbie friendliness 25/100

python-openapi/openapi-spec-validator#373 · 1 comment · Opened Aug 9, 2024
Need of recursive properties check in validation Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#372 · Opened Aug 8, 2024
How to read from string? Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#362 · 4 comments · Opened Jun 26, 2024
Numbers converted into scientific notation are not considered valid numbers Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#308 · 2 comments · Opened Nov 16, 2023
Validator doesn't report properties that are in the required list but not defined Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#266 · 1 reaction · Opened Aug 18, 2023
removing default_handlers breaks openapi-core Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

python-openapi/openapi-spec-validator#173 · 2 comments · 3 reactions · Opened Sep 2, 2022
No specific error information available. Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#160 · 8 reactions · Opened Jul 29, 2022
Duplicates schemas definitions are not validated Open

Difficulty 3/5 1-2 days Newbie friendliness 40/100

python-openapi/openapi-spec-validator#156 · Opened Jun 22, 2022
show the full path of the error/warning in iter_errors Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#152 · 1 reaction · Opened Apr 26, 2022
openapi_spec_validator hands on create_spec on jsonschema 4.0.1 Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

python-openapi/openapi-spec-validator#131 · 1 comment · Opened Oct 1, 2021
Failures in oneOf, anyOf, etc, are actually in the referenced schema Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#126 · 2 comments · Opened May 19, 2021
Query strings in paths do not throw validation error Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#118 · Opened Mar 19, 2021
`Failed validating 'oneOf' in schema['properties']['paths']['patternProperties']['^\\/']['patternProperties']['^(get|put|post|delete|options|head|patch|trace)$']['properties']['parameters']['items']:` Open

kind/question

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python-openapi/openapi-spec-validator#116 · 2 comments · 4 reactions · Opened Mar 2, 2021
Giving an integer value as default for a double, causes the validation to fail Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python-openapi/openapi-spec-validator#115 · Opened Mar 1, 2021
InvalidSpecification raised for OperationId Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#114 · Opened Feb 28, 2021
Allow "required" list to have undefined properties Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#97 · 4 comments · 1 reaction · Opened Aug 3, 2020
Validator doesn't work with custom server url Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#95 · Opened Jun 2, 2020
Reports spec as valid when other validators do not Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python-openapi/openapi-spec-validator#89 · Opened Jan 29, 2020
Unescaped DELETE control character U+007F fails with "unacceptable character" Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

python-openapi/openapi-spec-validator#88 · Opened Jan 27, 2020
How can I get a resolved json? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

python-openapi/openapi-spec-validator#87 · 4 comments · Opened Jan 21, 2020
Invalid URL error is cryptic Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#86 · 1 comment · Opened Nov 14, 2019
legal regex doesn't validate Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

python-openapi/openapi-spec-validator#85 · 1 comment · Opened Nov 4, 2019
links without operationId Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#82 · Opened Sep 4, 2019
validate component name Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#81 · Opened Sep 4, 2019
Failed validating 'oneOf' Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

python-openapi/openapi-spec-validator#80 · 1 comment · 5 reactions · Opened Sep 4, 2019
openapi-spec-validator fails for integer response codes Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#79 · 2 comments · 1 reaction · Opened Jul 21, 2019
Only top-level objects are validated Open

kind/bug/confirmed

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#77 · 1 comment · 1 reaction · Opened May 28, 2019
remove $id and $schema from referred JSON schemata Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

python-openapi/openapi-spec-validator#70 · 1 comment · 1 reaction · Opened Mar 29, 2019
OpenAPI 3.0 spec pattern constant validation Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

python-openapi/openapi-spec-validator#57 · Opened Feb 23, 2019
Array with unspecified item specification passes validation Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

python-openapi/openapi-spec-validator#55 · 1 reaction · Opened Feb 12, 2019
Eliminate added x-scope attributes Open

kind/enhancement

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#53 · 7 reactions · Opened Jan 26, 2019
oneOf with discriminator on path Open

resolution/invalid

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#52 · 1 comment · Opened Jan 17, 2019
requestBody on GET method should be invalid Open

kind/bug/confirmed

Difficulty 3/5 1-2 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#49 · Opened Nov 8, 2018
oneOf fails in post parameter Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

python-openapi/openapi-spec-validator#46 · 2 comments · 1 reaction · Opened Sep 7, 2018
Catch duplicate schema properties Open

kind/bug/confirmed

Difficulty 4/5 3-5 days Newbie friendliness 20/100

python-openapi/openapi-spec-validator#43 · 1 comment · Opened Aug 2, 2018
Thin error messages: Open

kind/bug/confirmed

Difficulty 5/5 Over a week Newbie friendliness 10/100

python-openapi/openapi-spec-validator#17 · 2 comments · Opened Apr 21, 2018

python-openapi/openapi-spec-validator

Get new issues in your inbox