OpenAPI Validate
Validate an OpenAPI 3.0 or 3.1 document against the core spec rules. Catches the common shape errors (missing info, malformed paths, response status code typos) with clear paths and messages — without bundling the full 50 KB meta-schema. Set strict mode to also flag missing operationIds, descriptions, and other lints.
About OpenAPI Validate
OpenAPI Validate checks an OpenAPI 3.0 or 3.1 document against the core spec rules, catching common shape errors like a missing info object, malformed paths, or response status-code typos, each reported with a clear path and message. It does this without bundling the full 50 KB meta-schema, so it's quick. Turn on strict mode to also flag missing operationIds, descriptions, and similar lints, and note that your spec is validated entirely in your browser.
- Category
- inspect
- Input
- Accepts: application/json, application/yaml, text/yaml or text/plain.
- Output
- Outputs: application/json.
- Cost
- Free, runs in your browser
- Memory
- low
Common uses
- Catch a malformed path or missing info block before committing an API spec to your repo
- Validate a hand-edited OpenAPI file that broke your code generator with an unhelpful error
- Run strict mode to enforce that every operation has an operationId before generating clients
- Check a YAML spec for response status-code typos that would slip past a casual review
- Confirm a 3.0 document still validates after migrating it toward 3.1
- Lint a contributor's OpenAPI changes in a PR without setting up a full validation toolchain
Frequently asked questions
Which OpenAPI versions are supported?
Both 3.0 and 3.1 documents are validated against the core spec rules for those versions.
What input formats does it take?
JSON or YAML, pasted as application/json, application/yaml, text/yaml, or plain text. It returns a JSON report.
What's the difference between normal and strict mode?
Normal mode catches structural errors that violate the spec. Strict mode additionally flags lints like missing operationIds and descriptions that aren't errors but are good practice.
Is my API spec uploaded to a server?
No. Validation runs in your browser, which matters since specs often describe internal endpoints you'd rather not send anywhere.
Why doesn't it bundle the full meta-schema?
It checks the common, high-value rules directly instead of shipping the 50 KB meta-schema, keeping it fast while still catching the errors that actually break tooling.
Keywords
- openapi
- swagger
- api
- validate
- lint
- spec