Plans

oasdiff is open source. The CLI and GitHub Action annotations are free forever. Upgrade to Pro for a richer PR review experience.

Free

Open source. Always free.

oasdiff CLI — all commands
300+ breaking change rules
GitHub Action with inline annotations
All output formats (JSON, YAML, text, HTML)
CI/CD integration (any platform)
Composed mode & multi-file specs
Open source — self-host or extend

View on GitHub

Now available

Pro

For teams who review API changes in PRs.

$100/month

30-day free trial · No credit card required · Cancel anytime

Everything in Free
Rich PR comment — auto-updating, one per PR
Changes organized by severity (breaking → warnings → info)
Inline links to affected spec lines
Base and revision source locations for all 300+ rules
Hosted report with side-by-side diffComing soon

Start free trial

What the PR comment looks like

A single auto-updating comment on the PR timeline — modeled after Codecov.

oasdiff API Change Report

🔴 3 breaking changes·🟡 2 warnings·🟢 5 info

Breaking changes (3)

Change	Path	Location
Required property `email` removed	POST /users	base.yaml:42Opens base.yaml at line 42 — where the removed property was defined
Response status `200` removed	GET /orders	base.yaml:28Opens base.yaml at line 28 — where the removed status was defined
Parameter `limit` type: integer → string	GET /products	revision.yaml:15Opens revision.yaml at line 15 — where the type was changed

Compared base.yaml ← revision.yaml · Powered by oasdiff

Getting started with Pro

Sign up

Add to your workflow

Add the oasdiff PR comment action to your GitHub Actions workflow with your token.

See it in PRs

Every API spec change gets a rich PR comment, auto-updated on every push.

.github/workflows/api-diff.yml

- uses: oasdiff/oasdiff-action/pr-comment@v0.0.30
  with:
    base: base/openapi.yaml
    revision: openapi.yaml
    oasdiff-token: ${{ secrets.OASDIFF_TOKEN }}

Common questions

Will the CLI always be free?

Yes. oasdiff is open source and the CLI stays free forever. The paid tier adds the hosted service layer (PR comments, hosted reports) on top.

What is the oasdiff-token?

An API token that authenticates your team with the oasdiff service. Sign in with GitHub to get one — your token is available instantly after signup. Each token is associated with your account.

Does this work with multi-file specs?

Yes. oasdiff tracks source locations across $ref chains, so breaking changes in referenced schemas point to the right file and line.

How is pricing structured?

$100/month per organization, billed monthly. Start with a 30-day free trial — no credit card required.