Varen Docs
Changes

Spec Compare

Compare two OpenAPI specs side by side with the free Spec Compare tool.

Varen includes a free, public Spec Compare tool that lets you compare two OpenAPI specifications and see exactly what changed.

How to use it

  1. Go to varen.dev/tools/openapi-diff
  2. Paste your old spec (v1) on the left
  3. Paste your new spec (v2) on the right
  4. Click Compare

The tool will show you every difference, categorized by type:

  • Added endpoints, parameters, or fields
  • Removed endpoints, parameters, or fields
  • Breaking changes (required parameters added, fields removed, etc.)
  • Deprecated endpoints or parameters
  • Changed response codes, descriptions, or types

Supported formats

  • JSON — standard OpenAPI 3.x or Swagger 2.0 JSON
  • YAML — standard OpenAPI 3.x or Swagger 2.0 YAML

The tool auto-detects the format.

Privacy

Spec Compare runs entirely in your browser. Your specs are never sent to a server. Nothing is stored or logged.

Example

The tool includes a pre-loaded example comparing two versions of the Petstore API so you can try it immediately without pasting your own specs.

No signup required. Spec Compare is free and works without an account.

Change Details

Understanding a change event and its components.

Deprecation Calendar

Track upcoming API sunset deadlines in a monthly calendar view.

On this page

How to use itSupported formatsPrivacyExample