CheckOps home

Tools directory

S

CheckOps

Specmatic

Specmatic is an MIT-licensed contract-driven development tool that turns API specifications (such as OpenAPI) into executable contracts for contract tests, intelligent service virtualization and backward-compatibility checks.

Visit website

Latest public signals

Not refreshed yet. Refresh reads the public site and, when the entry has a GitHub repository, the latest release.

Visit Website

Introduction

Specmatic turns API specifications into executable contracts, continuously verifying that every change made by engineers, and increasingly by AI coding agents, stays true to the intended behaviour, according to its README. The idea, which it calls contract-driven or spec-driven API development, is to make dependencies between services explicit so integration problems are caught early, before services are deployed together.

From the same specification, Specmatic can run contract tests against a provider, generating requests from the specification and validating responses, and can start a service virtualization stub for consumers that returns responses conforming to the specification. Its documentation also covers backward-compatibility checks that compare versions of a specification to catch breaking changes in pull requests, and support for multiple specification formats beyond OpenAPI (see the docs for the current list). It runs as a CLI, a Docker image or a JVM library with JUnit integration. The MIT-licensed core is developed on GitHub, and release 2.56.1 was published on 11 November 2026; the company also offers commercial products, so check the site for what is included in the open-source edition.

The source code is at specmatic/specmatic on GitHub under the MIT licence, with about 401 stars; the most recent commit was on 11 November 2026.

Features

  1. Specs as contracts: OpenAPI and other specifications become executable tests.
  2. Contract tests: Generated requests validate provider behaviour.
  3. Service virtualization: Spec-conformant stubs for consumers.
  4. Compatibility checks: Detect breaking spec changes in CI.

Pros

  1. Free to use: Open source under the MIT licence, so the core tool costs nothing to use.
  2. Actively maintained: The repository had commits as recent as 11 November 2026.

Cons

  1. Spec quality matters: Results are only as good as the specification.
  2. Open-source vs commercial features: Some capabilities may be commercial; see site.
# Contract-test a running provider against its OpenAPI spec (Docker)
docker run --network host -v "$PWD:/usr/src/app" specmatic/specmatic test api/orders.yaml --testBaseURL=http://localhost:8080

# Start a stub for consumers from the same spec
docker run -p 9000:9000 -v "$PWD:/usr/src/app" specmatic/specmatic stub api/orders.yaml

Resources:

Pricing

Specmatic is free and open source under the MIT licence.

  1. Microservice teams wanting API specifications to drive tests and stubs.
  2. Platform teams guarding against breaking API changes.

Conclusion

Specmatic is a strong option for contract-driven API development, turning existing specifications into tests, stubs and compatibility gates.

Compare

CheckOps pages that put Specmatic next to related tools. There is no paid placement on these lists.

Alternatives

Other tools on CheckOps that cover similar ground. Open a page, or compare one with Specmatic side by side.