Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

oasdiff

oasdiff.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
8.1 Club score Visit oasdiff.com

What oasdiff is

oasdiff compares OpenAPI specifications, creates changelogs and detects breaking changes before release. It supports OpenAPI 3.0, 3.1 and 3.2, with coverage for 755 distinct breaking and non-breaking API changes. The CLI can be installed through Homebrew, a shell installer, Docker or pre-built Linux, macOS and Windows binaries. It can output text, JSON, YAML, HTML, Markdown and GitHub Actions annotations.

A GitHub Action compares a pull request specification with a base branch and adds inline breaking-change annotations. The browser diff tool compares OpenAPI or Swagger specifications without installation or sign-up. Specs and changelogs are encrypted client-side before upload; servers retain ciphertext that oasdiff cannot read. The engine, CLI and GitHub Action are open source under Apache 2.0. The free plan includes CLI diffing, changelogs, GitHub Action annotations, side-by-side review and encrypted spec storage. Pro costs $100 per month and adds approval workflows, an audit trail, a merge gate and up to five reviewers across five repositories. A 30-day trial is listed.

Who it suits

It suits developers and teams that review OpenAPI changes before release, especially those using GitHub workflows. The browser tool is available for specification comparisons without installation or sign-up.

Good to know, and what to watch

  • Supports OpenAPI 3.0, 3.1 and 3.2.
  • Detects 755 distinct API changes.
  • CLI offers six listed output formats.
  • Browser comparisons require no installation or sign-up.
  • The engine, CLI and GitHub Action use Apache 2.0.
  • AsyncAPI is not supported.
  • GraphQL is not supported.
  • Free review links expire after seven days.
  • Pro costs $100 per month.

Enterprise

—

Free

Free

Pro

$100/mo

Free plan · 30-day trial

Getting started

  1. Open the web diff tool to compare OpenAPI or Swagger specifications without installing or signing up.
  2. Install the CLI through Homebrew, a shell installer, Docker, or a pre-built binary for Linux, macOS, or Windows.
  3. Use the free plan for CLI diffing, changelogs, GitHub Action annotations, and side-by-side review.
  4. Choose Pro at $100/month for approval workflow, audit trail, merge gate, and up to five reviewers across five repositories.
  5. Use the GitHub Action to compare a pull-request specification with its base branch and add inline annotations.

Limits to check

Free review links expire after 7 days. Pro is $100/month and supports up to five reviewers across five repositories; Enterprise pricing is custom.

The Club's review

oasdiff is an OpenAPI comparison and review tool for developers and teams responsible for API changes. It is strongest when OpenAPI checks need to fit into command-line or GitHub workflows, with a browser option for occasional comparisons. The free core is substantial, but formal review controls cost $100 per month.

Overview

oasdiff compares OpenAPI specifications, creates changelogs, and detects breaking changes before release. Support for OpenAPI 3.0, 3.1, and 3.2 and coverage of 755 distinct breaking and non-breaking changes make it useful for reviewing ordinary contract evolution as well as compatibility risks. The boundary is clear: it does not support AsyncAPI or GraphQL.

The comparison engine, CLI, and GitHub Action are open source under Apache 2.0. The product also offers a web diff tool and paid collaboration controls, while supporting self-hosted deployment. That mix suits teams that want to adopt the comparison tooling without immediately committing to paid review management.

Key features

Fit comparisons to the workflow

The CLI installs through Homebrew, a shell installer, Docker, or pre-built binaries for Linux, macOS, and Windows. It can produce text, JSON, YAML, HTML, Markdown, and GitHub Actions annotations, which makes it adaptable to scripts, reports, and automated checks. Composed mode compares collections of OpenAPI files together, a useful option when an API is divided across microservices.

The GitHub Action compares a pull request's specification with the base branch and adds inline annotations for breaking changes. That puts compatibility feedback where code review happens, rather than relying on someone to run a separate check. The hosted MCP server also works with Claude, Cursor, and other Streamable HTTP MCP clients, extending access to AI-assisted workflows.

Browser reviews and privacy

The browser diff tool compares OpenAPI or Swagger specifications without installation or sign-up, then exports text, YAML, JSON, Markdown, or HTML. It is a practical route for a one-off comparison, though teams needing durable review coordination will benefit more from the paid workflows.

Specs and changelogs are encrypted client-side before upload, and the servers retain ciphertext that oasdiff cannot read. Free review links expire after 7 days; Pro reviews last for the life of the pull request. Enterprise can load specifications directly from GitHub using each reviewer's access, without uploading or storing them. That no-upload mode is the strongest fit for organizations with stricter data-handling requirements.

Pricing

Free: free, billed Free forever. It includes CLI diff, breaking-change detection and changelogs, GitHub Action inline PR annotations, side-by-side review, and encrypted spec storage, with no account required. This is a capable starting point for individuals and teams that can work without formal approvals or longer-lived reviews.

Pro: $100 a month, billed $100/month. It adds an approval workflow, audit trail, and merge gate, with up to 5 reviewers across 5 repositories. Those limits suit a small team that needs controlled sign-off; teams with more reviewers or repositories need Enterprise.

Enterprise: custom pricing. It includes unlimited repositories and reviewers, an SLA, dedicated support, and an optional no-upload GitHub mode. A 30-day trial is available. Support and security or procurement contact is available through [email protected].

Platforms

oasdiff covers API, Linux, macOS, Windows, web, and self-hosted use. The CLI's installation choices support developer machines and build environments, while the browser tool avoids installation for quick comparisons.

Who it's for

Choose oasdiff if your contracts are OpenAPI-based and you want broad change detection in scripts or pull requests, or a browser tool for ad hoc reviews. The free plan is especially suitable when inline feedback and comparison are enough. Pro makes more sense when reviews need approvals, an audit trail, and a merge gate. Look elsewhere if your contracts use AsyncAPI or GraphQL, or if your team needs more than five reviewers or repositories without moving to custom-priced Enterprise.

Pros and cons

  • Pros: Broad coverage across 755 breaking and non-breaking changes helps catch more than compatibility breaks.
  • Pros: Open-source CLI and GitHub Action, multiple output formats, and a no-account browser diff offer several ways to adopt it.
  • Pros: Client-side encryption and Enterprise's optional no-upload GitHub mode address different levels of specification privacy.
  • Cons: No AsyncAPI or GraphQL support rules it out for teams using those contract formats.
  • Cons: Free review links expire after 7 days, and approvals, audit trails, and merge gates require Pro.
  • Cons: Pro is limited to 5 reviewers across 5 repositories, so larger teams must consider custom-priced Enterprise.

Alternatives

For contract-testing approaches beyond OpenAPI comparison, consider Pact, whose official site presents open-source tooling and links to GitHub, or Pact Broker, whose free Starter plan includes unlimited users, two integrations, and bi-directional contract testing. PactFlow is another freemium option in this category.

If you need event-stream infrastructure rather than specification review, Confluent Cloud offers a free Basic tier with serverless managed clusters, autoscaling Kafka resources, and more than 80 managed connectors. For GraphQL schema operations, GraphQL Hive has a free Hobby plan with 1M operations per month and 7-day usage-data retention.

For a broader API development and testing workflow, Microcks is a free, open-source, community-driven CNCF Incubating project. Specmatic has a free open-source plan covering OpenAPI, WSDL, and MCP contract testing, API resilience testing, and service virtualization. Karate is a freemium framework whose free plan covers REST, GraphQL, and SOAP API testing as well as browser and desktop UI automation.

For more options, browse Contract Testing Tools, API Governance Software, and API Design Tools.

Verdict

oasdiff is a strong choice for OpenAPI teams that want a broad, open-source comparison engine with useful CLI and pull-request workflows, plus an approachable free browser tool. Its main drawback is that review governance is paywalled and Pro's reviewer and repository caps are tight for larger organizations. Choose it for focused OpenAPI change review; look elsewhere if you need AsyncAPI or GraphQL support, or broader contract-testing scope.

The verdict

oasdiff offers specification comparison through a CLI, GitHub Action and browser tool, with support for several review workflows. It is focused on OpenAPI rather than AsyncAPI or GraphQL; Pro adds team review controls for $100 per month.

Questions people ask

Is there a free plan?

Yes. The Free plan costs nothing and is billed free forever. It includes CLI diffing, breaking-change detection and changelog, GitHub Action inline PR annotations, side-by-side review, and encrypted spec storage.

How much does Pro cost?

Pro costs $100 per month. It includes approval workflow, audit trail, merge gate, and up to five reviewers across five repositories.

Does oasdiff offer a free trial?

Yes. A 30-day trial is listed.

Which platforms and specification formats does it support?

Platforms include API, Linux, macOS, self-hosted, web, and Windows. It supports OpenAPI 3.0, 3.1, and 3.2 in JSON and YAML.

Is oasdiff open source?

The oasdiff engine, including its CLI and GitHub Action, is open source under the Apache 2.0 license.

Does it support AsyncAPI or GraphQL?

No. AsyncAPI and GraphQL support are listed as unavailable.

What the maker publishes

AI integrations
oasdiff provides a hosted MCP server that works with Claude, Cursor, and other Streamable HTTP MCP clients. source
Browser tool
The web diff tool compares OpenAPI or Swagger specifications without installation or sign-up and exports text, YAML, JSON, Markdown, and HTML. source
Change coverage
oasdiff detects 755 distinct breaking and non-breaking API changes. source
CLI installation
The CLI is available through Homebrew, a shell installer, Docker, and pre-built Linux, macOS, and Windows binaries. source
Encryption
Specs and changelogs are encrypted client-side before upload, and servers retain only ciphertext that oasdiff cannot read. source
Enterprise privacy
Enterprise can load specs directly from GitHub at review time using each reviewer's access without uploading or storing specs. source
GitHub integration
The GitHub Action compares pull-request and base-branch specifications and adds inline breaking-change annotations. source
Microservices
Composed mode compares collections of OpenAPI files together for APIs split across multiple services. source
OpenAPI support
oasdiff supports OpenAPI 3.0, 3.1, and 3.2. source
Open source
The oasdiff engine, including its CLI and GitHub Action, is open source under the Apache 2.0 license. source
Output formats
CLI output supports text, JSON, YAML, HTML, Markdown, and GitHub Actions annotations. source
Purpose
oasdiff compares OpenAPI specifications, generates changelogs, and detects breaking changes before release. source
Review retention
Free review links expire after 7 days, while Pro reviews remain for the life of the pull request. source
Support
oasdiff provides support and security or procurement contact through [email protected]. source

Checked against the maker's pages on 1 Oct 2026.