OpenAPITools/openapi-diff

View on GitHub

Utility for comparing two OpenAPI specifications.

Stars: 1.1k
Forks: 190
Open beginner issues: 0
Indexed issues: 69

Dominant language: Java
License: Apache-2.0
Last GitHub push: Aug 5, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted good first issue
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

69 open issues indexed

Property `type` change on referenced component schema is silently ignored Open

bug OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#910 · 1 comment · Opened Jun 12, 2026
Changes reported in operations but only securityScheme changed Open

Render capabilities

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

OpenAPITools/openapi-diff#893 · 1 comment · Opened Feb 25, 2026
[Bug] Backward compatibility check fails on reordered discriminator mappings Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#886 · Opened Jan 30, 2026
Feature Request: generate Overlay for the given 2 OpenAPI files Open

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

OpenAPITools/openapi-diff#883 · Opened Jan 20, 2026
Renderers should display example changes, not just schema changes Open

Render capabilities

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

OpenAPITools/openapi-diff#872 · Opened Nov 28, 2025
Operations are detected as changed when comparing for open api version 3.0.1 and 3.1.0 Open

OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#858 · Opened Nov 7, 2025
Operation description change is detected as a change but it is not rendered by HtmlRender Open

Render capabilities

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

OpenAPITools/openapi-diff#857 · Opened Nov 7, 2025
TeamCity renderer Open

Render capabilities

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

OpenAPITools/openapi-diff#849 · Opened Oct 14, 2025
ExtensionDiff in renderers (just tried console and html) Open

enhancement Render capabilities

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

OpenAPITools/openapi-diff#839 · 1 comment · Opened Sep 25, 2025
Mark down changelog generation - enum rename interpreted as added Open

OpenAPITools/openapi-diff#828 · 1 comment · 1 reaction · 1 assignee · Opened Sep 11, 2025
IllegalArgumentException: "Invalid ref..." when uses an external link like "../demo#/components" Open

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

OpenAPITools/openapi-diff#810 · 2 comments · 1 reaction · Opened Aug 11, 2025
Bug: erroneous detection of changes with mediaTypes, failure to generate html/markdown reports Open

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

OpenAPITools/openapi-diff#805 · 1 comment · Opened Aug 7, 2025
Bug: no details when securitySchemes.*.name changes Open

OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#802 · Opened Jul 17, 2025
Changing response field type from `oneOf: string, number` to `string` shouldn't break Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#798 · 4 comments · Opened Jul 4, 2025
Changing request field type from `string` to `oneOf: string, number` shouldn't break Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#797 · Opened Jul 4, 2025
Support for detecting changes in webhooks Open

OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#793 · Opened Jun 17, 2025
Exception in thread "main" java.lang.StackOverflowError Open

bug

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

OpenAPITools/openapi-diff#788 · Opened May 26, 2025
Unify Handling of allOf/anyOf and oneOf in Diff logic Open

enhancement

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

OpenAPITools/openapi-diff#772 · Opened Apr 22, 2025
Markdown output does not specify whether the change is backward-compatible or not Open

Breaking/Non-Breaking classification Render capabilities

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

OpenAPITools/openapi-diff#766 · 1 comment · 1 reaction · Opened Apr 5, 2025
Comparing OpenAPI 3.0.1 to 3.1.0 does not work Open

OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#755 · 5 comments · 1 reaction · Opened Mar 14, 2025
[OpenAPI 3.1.0 support] JsonSchema type changes not handled. Open

OpenAP 3.1.0 Support

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

OpenAPITools/openapi-diff#745 · Opened Feb 10, 2025
Missing #/components/securitySchemes section leads to IllegalArgumentException Open

good first issue help wanted

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

OpenAPITools/openapi-diff#737 · Opened Jan 30, 2025
Schema description update should be considered as a metadata change Open

Breaking/Non-Breaking classification duplicate

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

OpenAPITools/openapi-diff#694 · 2 comments · Opened Aug 13, 2024
Deleted or renamed properties are marked as backwards compatible Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#673 · 7 comments · 3 reactions · Opened Jun 14, 2024
Report totals Open

enhancement

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

OpenAPITools/openapi-diff#627 · 1 reaction · Opened Mar 5, 2024
Output in text and markdown not equivalent (text output incomplete) Open

enhancement Render capabilities

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

OpenAPITools/openapi-diff#620 · 2 comments · 1 reaction · Opened Feb 19, 2024
No backward compatible changes in Schema are marked as Compatible Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#611 · 4 reactions · Opened Jan 16, 2024
The current openapi-diff implementation does not capture differences in extensions that occur at the properties level (attributes under the type object) and the path level Open

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

OpenAPITools/openapi-diff#604 · Opened Dec 28, 2023
Removing a mandatory or optional property in the input data : breaking change ? Open

Breaking/Non-Breaking classification question

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

OpenAPITools/openapi-diff#599 · 2 comments · Opened Dec 19, 2023
[bug] [polymorphism] Changes in child schema are ignored when only parent schema is directly referenced Open

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

OpenAPITools/openapi-diff#571 · 1 comment · Opened Sep 21, 2023
--json output is absurdly huge Open

enhancement Render capabilities

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

OpenAPITools/openapi-diff#562 · 1 comment · 8 reactions · Opened Sep 8, 2023
incompatible api diff result when one of property in model becomes not required Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#535 · 2 comments · 1 reaction · Opened Jun 22, 2023
[2.1.0-beta.6 and oas-3.1.0] Request body property data type change is detected as compatible or no_change Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#528 · 1 comment · 3 reactions · Opened Jun 2, 2023
enum and properties change in schemas not reported in .md file generated after diff check Open

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

OpenAPITools/openapi-diff#523 · Opened May 17, 2023
`--state` option outputs `metadata` Open

good first issue

Difficulty 2/5 1-3 hours Newbie friendliness 50/100

OpenAPITools/openapi-diff#508 · Opened Apr 18, 2023
In openapi-diff-cli add old and new filenames to the output Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

OpenAPITools/openapi-diff#506 · Opened Apr 4, 2023
False positive when adding optional property Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#490 · 3 comments · 1 reaction · Opened Mar 14, 2023
Using a reference in items of array results in error Open

duplicate

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

OpenAPITools/openapi-diff#464 · 3 comments · Opened Feb 15, 2023
Do not fail with breaking changes when major version is bumped Open

Breaking/Non-Breaking classification enhancement

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

OpenAPITools/openapi-diff#460 · 2 comments · Opened Feb 3, 2023
Removing a Query parameter is considered a breaking change while removing a Request Body parameter isn't Open

Breaking/Non-Breaking classification help wanted

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

OpenAPITools/openapi-diff#412 · 1 comment · Opened Sep 15, 2022
allOf : `type` of property contained in multiple subschemas is not correctly determined. Open

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

OpenAPITools/openapi-diff#392 · 4 comments · 2 reactions · Opened Jul 4, 2022
Consider removal of deprecated elements as compatible Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#371 · 4 comments · Opened May 5, 2022
HtmlRender: Notes of Parameters shows always the new description Open

good first issue help wanted

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

OpenAPITools/openapi-diff#364 · Opened Apr 5, 2022
Problem creating changelog in HTML Open

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

OpenAPITools/openapi-diff#362 · Opened Apr 4, 2022
ChangedSchema in a readOnly property for requestBody is not filtered out from the result. Open

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

OpenAPITools/openapi-diff#357 · Opened Mar 24, 2022
Template-based output Open

enhancement help wanted

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

OpenAPITools/openapi-diff#355 · 1 reaction · Opened Mar 15, 2022
Removing a security scheme is considered incompatible Open

Breaking/Non-Breaking classification question

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

OpenAPITools/openapi-diff#330 · 1 comment · Opened Jan 28, 2022
False positive breaking change when making a required request body optional Open

Breaking/Non-Breaking classification

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

OpenAPITools/openapi-diff#329 · 6 reactions · Opened Jan 28, 2022
Markdown output does not contain compatibility information Open

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

OpenAPITools/openapi-diff#325 · 2 comments · 12 reactions · Opened Jan 18, 2022
Evaluate creating native images Open

enhancement

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

OpenAPITools/openapi-diff#310 · Opened Dec 27, 2021

OpenAPITools/openapi-diff

Get new issues in your inbox