Skip to main content



This rule belongs to the swagger-v1-validation ruleset and states that:

Your Swagger specification's root object must specify a valid Swagger standard document version using the 'swaggerVersion' property. The value must be set to one of the following: 1.0, 1.1, 1.2.

Maximum SeverityBlocking
MessageSpecification version number of the Swagger standard document is invalid.
Rule SystemSemantic
Broad CategoryBasic Structure
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsswagger1 swagger semantic validation version

Suggested Fixes

  • Ensure that the value of swaggerVersion property is not null or empty.
  • Ensure that the value of swaggerVersion property is set either as 1.0, 1.1 or 1.2.
  • This version is not to be confused with the API version or the API specification document version which is specified using the apiVersion property.

For More Information