Skip to content

Entente

Contract based API testing. Build reliable APIs with confidence.

Entente is a modern contract testing platform that combines OpenAPI specifications with real interaction recording to provide automated contract testing between services. It helps teams build reliable APIs with confidence.

OpenAPI-First

All contracts start with OpenAPI specifications, ensuring clear API definitions from the beginning.

Automatic Recording

CI environments automatically record real interactions of a consumer against its mocks to replay against the actual provider service.

Smart Fixtures

Ability to record and store fixtures from one consumer to re-use in others, with centralised management and approval.

Real Verification

Providers verify against actual consumer usage, not just theoretical contracts.

For Providers

Learn how to verify your API implementations against real consumer interactions. Provider Guide →

For Consumers

Learn how to test against realistic mocks and record interactions. Consumer Guide →

Entente follows a TypeScript-first functional programming approach with a pnpm workspace monorepo structure:

  • @entente/consumer - Consumer testing library
  • @entente/provider - Provider verification library
  • @entente/fixtures - Fixture management utilities
  • @entente/cli - Command line interface
  • @entente/server - Central service with Hono API + React UI

You can run it yourself on Cloudflare Workers with Neon PostgreSQL for data persistence.