In-browser OpenAPI breaking-change detector

Paste two OpenAPI 3.x or Swagger 2.0 spec versions and instantly see every breaking and non-breaking change. JSON or YAML. Nothing leaves your browser — the diff runs entirely on this page.

Try an example:

How changes are classified

APIDiff walks every path × method in both specs, resolves local $ref pointers (with a cycle guard), normalizes Swagger 2.0 into an OpenAPI-3-shaped model, then classifies each difference by how it affects an existing client.

Breaking

  • Removed endpoint or method
  • New required parameter, request property, or request body
  • Parameter or property becoming required
  • Parameter moved (e.g. query → path)
  • Type / format change on a field
  • Removed response field (response contract shrinks)
  • Request enum narrowed, response enum widened
  • Auth scheme added or strengthened
  • Request body / response content-type removed

Non-breaking

  • Added endpoint, method, or response
  • Added optional parameter or property
  • Parameter / property becoming optional
  • Request enum widened
  • Marked deprecated
  • Description changes
  • Auth scheme removed

Info

  • operationId rename
  • Summary / tag changes
  • info.version bump

Classification is heuristic and errs toward flagging risk. It is a paste-and-look aid, not a substitute for reading the diff — see the honest limitations in the README.