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.

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

Request access

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

Request access

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@main
  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. Contact us to get one. Each token is associated with your GitHub organization.

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?

Per organization. Contact us to discuss the right plan for your team size and number of repos.