How to use OpenAPI Specification Inspector
- Paste a supported JSON or YAML specification, or choose one UTF-8 file to replace the text.
- Read the declared method, path, operation ID, parameters and response codes in the operation inventory.
- Review structural findings and unresolved references. Download openapi-structural-review.json to retain the inventory and findings.
- Run complete specification validation and any request tests in the API’s intended toolchain; this page does not contact endpoints.
Example: OpenAPI Specification Inspector
List a declared GET operation with its required id path parameter and 200 response.
Options
- Supported versions
- The declared version must be Swagger 2.0 or OpenAPI 3.0.3, 3.0.4, 3.1.0 or 3.1.1. This is a fixed structural subset, so a newer version is not accepted automatically.
- Operation declarations
- Selected checks cover basic API information, path and parameter structure, repeated operation IDs, response entries and required path parameters. The inventory describes supplied declarations; it does not establish actual responses or authorization behavior.
- Reference handling
- Direct local parameter references can supply parameter declarations. Path-item references are not expanded into operations. Missing, external, chained or cyclic references receive findings where recognized; external documents are never fetched.
Supported inputs and limits
- One JSON or safe YAML specification up to 100,000 UTF-8 bytes, 20,000 value nodes and 32 levels.
- YAML also has a 5,000-line limit and refuses anchors, aliases, merge keys, explicit tags, directives and repeated keys.
- Review at most 100 paths, 200 operations, 100 parameters per list, 100 responses per operation, 1,000 reference occurrences and 200 structural findings.
- Selected structural checks leave full conformance, schemas, bodies, callbacks, webhooks and authorization unverified.
More details
No external reference resolution, API request, authentication or URL fetch occurs.
Where your input is processed
This tool does not upload your inputs. See the limits for anything saved on your device.
Resolve the gaps in the intended toolchain
External references are not fetched and full specification conformance remains unverified. Use the inventory to find the relevant operation, then check unresolved references and complete validation in the API’s toolchain. A declared response or security requirement does not establish what the actual server returns or enforces.
Questions about OpenAPI Specification Inspector
Will this contact my API?
No. Paths and server URLs are read as document values only.
Does it validate every OpenAPI schema rule?
No. The result lists the supported structural checks and remaining review limits.
What happens to external references?
They are not fetched or resolved; the result identifies what still needs review.