swagger-api/swagger-parser

View on GitHub

Swagger Spec to Java POJOs

Stars: 867
Forks: 560
Open beginner issues: 1
Indexed issues: 290
Avg merge: 2d 21h
Merged PRs (30d): 7

Dominant language: Java
License: Apache-2.0
Last GitHub push: Aug 31, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

290 open issues indexed

[Bug]: Regression: resolveFully fails when components key does not match external file basename Open

Bug

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

swagger-api/swagger-parser#2399 · 3 comments · Opened Sep 3, 2026
[Bug]: Const: Null when passed in OpenApi 3.1 Yaml file is silently dropped by the swagger parser, hence producing invalid results Open

Bug

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

swagger-api/swagger-parser#2395 · Opened Aug 27, 2026
InlineModelResolver.uniqueName throws StringIndexOutOfBoundsException for titles starting with a separator (camelCaseFlattenNaming) Open

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

swagger-api/swagger-parser#2386 · Opened Aug 24, 2026
[Bug]: ResolverFully remaining recursion edge case after #2297 for OAS 3.1 self-referencing allOf schema Open

Bug

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

swagger-api/swagger-parser#2374 · Opened Aug 17, 2026
[Bug]: OpenAPI 3.1 same-file $ref resolution reports illegal path when raw local path contains spaces Open

Bug

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

swagger-api/swagger-parser#2365 · Opened Jul 7, 2026
Migrate from httpclient 4.5 to httpclient 5.x Open

Feature

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

swagger-api/swagger-parser#2362 · 1 reaction · Opened Jun 29, 2026
[Feature]: Pluggable URL validator for remote $ref resolution Open

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

swagger-api/swagger-parser#2348 · 1 comment · Opened Jun 12, 2026
[Bug]: OAS 3.1 dereferencer crashes on schemas with + , loses / during resolution Open

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

swagger-api/swagger-parser#2331 · Opened May 12, 2026
[BUG] State leaks across parse operations since 2.1.24, causing cross-module schema contamination in long-lived JVMs (mvnd) Open

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

swagger-api/swagger-parser#2295 · Opened Mar 23, 2026
[Bug]: content.examples $ref not resolved in request bodies or parameters Open

Bug

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

swagger-api/swagger-parser#2292 · Opened Mar 16, 2026
📢 Project Maintenance Update & Community Issue Housekeeping Open

announcement

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

swagger-api/swagger-parser#2284 · 5 reactions · Opened Mar 4, 2026
[Feature]: Cache the result of deserialization when loading ref Open

Feature

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

swagger-api/swagger-parser#2275 · Opened Feb 20, 2026
[Bug]: allOf reference not resolved fully Open

Bug

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

swagger-api/swagger-parser#2270 · 2 comments · 1 reaction · Opened Feb 5, 2026
[Bug]: External schema resolution broken in OpenAPI 3.1 (works in 3.0) Open

Bug

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

swagger-api/swagger-parser#2266 · 3 comments · Opened Jan 31, 2026
[Bug]: OpenAPI 3.1 Parser Unexpectedly Merges Identical Inline Objects When resolve=true Open

Bug

swagger-api/swagger-parser#2264 · 1 reaction · 2 assignees · Opened Jan 28, 2026
[Bug]: References to elements within jar files cannot be resolved Open

Bug

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

swagger-api/swagger-parser#2262 · Opened Jan 8, 2026
[Feature]: Upgrade to Jackson 3 Open

Feature

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

swagger-api/swagger-parser#2261 · 1 comment · 9 reactions · Opened Jan 8, 2026
[Feature]: Allow customization of Accept-header In RemoteUrl Open

Feature

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

swagger-api/swagger-parser#2257 · Opened Dec 15, 2025
[Question] [Bug]: Inconsistent Relative Reference Resolution in Nested Schema Contexts Open

Question

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

swagger-api/swagger-parser#2256 · 1 comment · Opened Dec 8, 2025
[Question]: Duplicate _1 Object generation due to different path prefix Open

Question

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

swagger-api/swagger-parser#2253 · 2 comments · Opened Nov 28, 2025
[Feature]: Support for OpenAPI Spec 3.2 Open

Feature

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

swagger-api/swagger-parser#2248 · 5 comments · 19 reactions · Opened Nov 13, 2025
[Bug]: Presence of path parameter in parent reference leads to unresolved examples Open

Bug

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

swagger-api/swagger-parser#2244 · Opened Nov 5, 2025
[Bug]: Loss of Float Precision When Reading Yaml Files Open

Bug

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

swagger-api/swagger-parser#2242 · Opened Nov 3, 2025
Fix unresolved relative $ref for examples in parameter definitions Open

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

swagger-api/swagger-parser#2229 · 1 comment · 1 reaction · Opened Sep 8, 2025
[Bug]: Parameters components shouldn't be inlined with resolve option set to true Open

Bug

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

swagger-api/swagger-parser#2216 · 6 comments · Opened Aug 5, 2025
[Feature]: Introduce resolveResponsesFully Open

Feature

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

swagger-api/swagger-parser#2215 · Opened Aug 5, 2025
[Openapi3.1] Ref inside of Items are not resolved Open

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

swagger-api/swagger-parser#2201 · 1 comment · Opened Jun 11, 2025
Unquoted integer `example:` value fails to parse when the spec includes a deeply nested schema elsewhere in spec Open

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

swagger-api/swagger-parser#2200 · Opened Jun 9, 2025
Default server URL "/" is added automatically when parsing OpenAPI 3 spec Open

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

swagger-api/swagger-parser#2197 · Opened May 29, 2025
Circular dependencies are not resolved properly with resolveFully Open

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

swagger-api/swagger-parser#2193 · Opened May 22, 2025
reference name is not displayed to $ref in local file Open

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

swagger-api/swagger-parser#2178 · Opened May 6, 2025
[OpenAPI v3.1] Arrays now (incorrectly?) parse to JsonSchema rather than ArraySchema Open

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

swagger-api/swagger-parser#2172 · 1 comment · Opened Apr 25, 2025
[OpenAPI v3]Not parsed the extensions in schema that with $ref field Open

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

swagger-api/swagger-parser#2168 · Opened Mar 27, 2025
openapi 3.1: Illegal character in fragment when path reference contains paramneters Open

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

swagger-api/swagger-parser#2159 · 4 reactions · Opened Mar 7, 2025
swagger parsers depends on NOT jakarta packages Open

Bug P2

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

swagger-api/swagger-parser#2158 · 2 comments · 2 reactions · Opened Feb 19, 2025
additionalProperties inside ComposedSchema are resolved as null Open

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

swagger-api/swagger-parser#2157 · 5 comments · 1 reaction · Opened Jan 24, 2025
OpenAPIV3Parser.resolve() should handle all errors in the entire spec Open

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

swagger-api/swagger-parser#2149 · Opened Jan 9, 2025
Request for a Simplified Swagger Parser with Minimal Dependencies Open

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

swagger-api/swagger-parser#2148 · 1 reaction · Opened Dec 31, 2024
cannot deserialize from Object value (Grallvm native executable) Open

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

swagger-api/swagger-parser#2147 · 4 comments · Opened Dec 29, 2024
Feature Request (and design proposal): `swagger-parser-cli` to implement conversion of v2 to v3 Open

2.0 support 3.0 spec support Feature

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

swagger-api/swagger-parser#2145 · Opened Dec 15, 2024
[Open API 3.1] Json31 is incorrectly assuming that property containing `anyOf` is of type: object Open

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

swagger-api/swagger-parser#2144 · Opened Dec 12, 2024
Parsing multipart/form-data body Open

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

swagger-api/swagger-parser#2135 · Opened Nov 4, 2024
Error: `There are duplicate parameter values` encountered when parsing OpenAPI spec Open

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

swagger-api/swagger-parser#2134 · 1 reaction · Opened Oct 30, 2024
Inline schemas get empty model name when title is empty Open

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

swagger-api/swagger-parser#2118 · 3 comments · Opened Aug 12, 2024
Unable to parse Parameter $ref with cross-path references Open

P2

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

swagger-api/swagger-parser#2116 · 2 comments · Opened Aug 12, 2024
Examples in the referenced paths are parsed differently than those in non-referenced paths. Open

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

swagger-api/swagger-parser#2111 · 1 reaction · Opened Jul 23, 2024
Referenced schemas in callback responses are not resolved [Regression in 2.1.19] Open

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

swagger-api/swagger-parser#2110 · 2 reactions · Opened Jul 10, 2024
$schema is null but the value of $schema should be string Open

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

swagger-api/swagger-parser#2107 · 1 comment · Opened Jun 25, 2024
Parameters with the same name but different locations are incorrectly returned when using JSON references ($ref) with openapi 3.0.x. Open

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

swagger-api/swagger-parser#2102 · 1 comment · 1 reaction · Opened May 16, 2024
Resolve fully does not resolve composed schemas or requestBodies schemas with options.setResolve(true); options.setResolveFully(true); options.setResolveCombinators(true) Open

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

swagger-api/swagger-parser#2101 · Opened May 13, 2024

swagger-api/swagger-parser

Get new issues in your inbox