OpenAPI Specification Inspector

Review supported API specification structures from pasted or uploaded JSON or YAML.

On-device No sign-up Free to use

Inspect input controls

Showing an example. Edit to see your own.

Drop your file here

or choose one from your device

Optional UTF-8 text up to 100,000 bytes. A chosen file replaces pasted text.

    ?

    100,000 UTF-8 bytes, 100 paths and 200 operations. YAML anchors, aliases, tags, merges and repeated keys are refused.

    Processed in your browser. Your inputs stay on this device.

    Result

    Showing an example.

    List a declared GET operation with its required id path parameter and 200 response.

    Inspected OpenAPI 3.0.4: 1 operation, 0 structural findings.

    Loading the tool. Your result will appear here.

    https://usefreetools.net/openapi-spec-inspector · 20 November 2026

    Was this helpful?

    How to use OpenAPI Specification Inspector

    1. Paste a supported JSON or YAML specification, or choose one UTF-8 file to replace the text.
    2. Read the declared method, path, operation ID, parameters and response codes in the operation inventory.
    3. Review structural findings and unresolved references. Download openapi-structural-review.json to retain the inventory and findings.
    4. 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.

    You add
    OpenAPI or Swagger JSON / YAML: openapi: 3.0.4 info: title: Example API version: 1.0.0 paths: /books/{id}: get: operationId: getBook parameters: - name: id in: path required: true schema: type: string responses: "200": description: A book
    You get
    Inspected OpenAPI 3.0.4: 1 operation, 0 structural findings.

    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.

    Page updated · Project managed by Tony Hines · Report a problem with OpenAPI Specification Inspector