Contract Driven Development

Micro-services done right without the pain of integration
Play Video
Supported Specification Standards

Shift left and kill integration tests

by leveraging API specifications as executable contracts to
identify compatibility issues between your microservices early in your development cycle

API Specifications as Executable Contracts


Contract as Test

Turn your API Specification into tests for free (No Code) and run them against your Services to identify integration issues early


Contract as Stub

No more stale stubs. Specmatic’s “Smart Service Virtualization” verifies your expecations / stub responses against your API Specifications

Backward Compatibility

Identify backward incompatible changes just by comparing two versions of your API Specifications with our unique “No Code” approach.
An image illustrating contract driven development through a printer and mobile phone.

API Specifications as Executable Contracts

Specmatic supercharges your API Specifications by leveraging them as “Executable Contracts”. Specmatic does this by

Smart Service Virtualization

Allows Consumer Application Development and Testing to progress independent of the Provider Application

API Specifications as Contract Tests

Generates Tests based on the API Specification File without you having to write any code

Contract as Test

Tests for Free – Specmatic parses your API Specification files and based on this generates requests which are fired at your application. It then verifies if your application’s response is as per your API Specification. All this with a “No Code” approach.

Positive Tests

Verify if the API implementation meets basic criteria as per your API Specification

Negative Tests

Verify boundary conditions to identify error handling, unexpected behaviour, etc.

A diagram illustrating the contracted connections between servers.
A diagram illustrating the contract-driven development process for a mobile app.

Contract as Stub

A component test setup should be able to isolate the “System Under Test” from its dependencies. Smart Service Virtuatlization enables you to achieve this by truly emulating the dependencies.

Smart Service Virtualization

Allows Consumer Application Development and Testing to progress independent of the Provider Application

Static and Dynamic Stubbing

Expectations can be set either at startup or dynamically at runtime (for workflow testing) through a http endpoint

Backward Compatibility

As API Specifcation authors / API designers it is important for us understand if our changes to existing APIs can break compatibility with existing API Consumers / Clients.

Specmatic can perform “Contract vs Contract” testing between two versions of your API Specification file and provide accurate results about backward compatibility breaking changes. Since this is a completely “No Code” capability, you do not have to write any code on the API Client or Service Applications.
Comparison between Specmatic v2 and Specmatic v1 in the context of contract driven development.
A diagram illustrating the contract-driven development process for using Jira.

Treat Contract as Code

Specmatic and Contract Driven Development promotes treating your API Specifications as code and storing them in a Version Control System where they truly belong.

Central Contract Repo

The “Single Source of Truth” for all your API Specifications so that stakeholders across the organization are on the same page.

Pull/Merge Request based Collaboration

Specmatic can help you identify backward compatibility breaking changes automatically as part of your pre-merge checks so that you can focus on API Design

Unleash the power of API Specifications

A yellow circle indicating contract driven development.

No Code

All capabilities of Specmatic are designed with a No Code approach in mind
A yellow circle with a contract document icon.

Multiple Protocols

HTTP, Kafka, SOAP, JMS, Redis, DB mocks and more

A python symbol enclosed in a yellow circle, representing contract driven development.

Platform Independent

Use the command line to integrate with any programmatic environment
A yellow circle representing contract driven development.

Language Agnostic

Specmatic is Programming Language agnostic since it is working at the API level

An icon representing a contract in a yellow circle.

Proxy Mode

As part of Smart Service Virtualization select endpoints and let other requests pass through to real Provider / service

A circle with a square in it, created through contract driven development.

Capture API Specifications

In Proxy Mode, Specmatic can capture your traffic and convert it into API Specifications
A contract-driven development approach using a yellow circle with a thermometer icon.

Negative Testing

Verify boundary conditions in your API implementations without writing a single line of code

A yellow circle representing contract driven development.

Woven into your CI Pipelines

Trigger Provider and Consumer CI builds when any of the contracts change
A circle with an arrow indicating contractual progress in the rightward direction.

Import your APIs

Use Postman Collections or Specmatic’s http proxy to create API Specifications

API Coverage Reports

API Coverage Reports ensure that your application and OpenAPI specification are always in sync

Database stubbing

Isolate your applications from their database dependencies with JDBC stubbing

And more...

Mock JMS and Kafka, stub Redis

See Specmatic in Action

Case Study

See how one organisation used Contract Driven Development to cut time to market in half and dramatically improved their code quality!

  • Implemented Contract Testing
  • Centralised contract repository
  •  Created DB test stub from live server
  • Auto-generated OpenAPI specs from live services

Want to jump start your CDD journey?

Explore Contract Driven Development in your organizations’s context with a 2-week guided proof-of-concept implementation.

Specmatic Team

Naresh Jain

Naresh Jain

Founder, CEO
Developer, Conference producer, Startup founder. Null Process Evangelist.
Hari Krishnan

Hari Krishnan

Co-founder, CTO
Polyglot Full Stack Developer, XP Coach and Trainer.
Joel Rosario

Joel Rosario

Co-founder, Chief Scientist
An engineer at heart, he loves building things that are useful to others.
A black and white photo of a man wearing glasses.

Vikram Rao

Technical Manager
Hands-on Principal Architect
A contract driven photo of a man smiling.

Jaydeep Kulkarni

Principal Architect
Senior Polyglot Developer

John Sinclair

John Sinclair

Marketing Manager
Digital Marketer and video producer

What users say about Specmatic

"Specmatic helped us build an executable deliverable based on the API Contract"
A man practicing contract driven development wearing glasses and a green shirt.
Nitin Supekar
Consulting Software Architect at Multiple Companies
Thought Leader, Transformation and Modernisation
"Specmatic is addressing some real problems in an interesting way"
Dave Farley
Co-author: "Continuous Delivery"
“Specmatic helped us achieve stable test environments by isolating dependencies through Smart Mocks”
A man smiling by the water.
Anand Bagmar
Quality Evangelist, Consultant, Solution Architect
"Our earlier attempts made use of Postman mocks, but we soon realised that solves a slightly different problem. We saw some holes in the tool chain that we want and Specmatic covers that."
Shivakumar Ramagopal
Group Engineering Manager: AJIO

Coming Appearances

Melbourne, Brisbane & Sydney, Australia.

30 Nov – 8 Dec 2023

Article Spotlight

Integration testing has become the largest hurdle impacting the independent development and deployment of microservices.


Featured Clients

Jio logo
Reliance Jio
A heart shaped logo with pink, purple, and blue colors.
JioMeet logo
Jio Meet
The logo for confingine, showcasing the essence of contract driven development.
Ajio logo
Tietoevry logo