WSO2 Contract Test Runner review
A focused self-hosted runner for detailed JSON REST contract assertions.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
WSO2 Contract Test Runner is an open-source library for consumer-driven contract testing against live REST API endpoints. Teams define JSON contract files containing requests, expected responses, and assertions, then run those contracts against API implementations. It is suited to REST teams that need detailed response validation in automated development or deployment workflows, with both consumer and provider verification supported.
Its assertion depth is the main reason to consider it. Tests can check status codes, headers, and bodies using exact, regular-expression, empty, array, object, and structural comparisons. JSONPath-based response validation adds more targeted checks for response content. Suite-level and global environment variables help adapt contracts across environments, while pre-contracts, before-suite contracts, and after-suite contracts support setup and cleanup stages around test execution.
The product takes a self-hosted approach, including Docker image execution. That fits teams comfortable incorporating a library or container into their own development and deployment workflows, rather than looking for a hosted testing service. Its scope is deliberately focused on JSON REST contracts, so teams working with those APIs get a concentrated set of assertions and lifecycle controls. Teams needing other contract formats or a broader protocol and API surface should choose a tool aligned with those requirements instead. Pick WSO2 Contract Test Runner for self-managed REST contract testing with granular JSON checks; avoid it when hosted operation or broader contract coverage is central.
WSO2 Contract Test Runner pros and cons
- Where it wins
- Validates live REST endpoints with consumer and provider verification
- Covers status, headers, body, JSONPath, and structural assertions
- Supports environment variables, lifecycle hooks, suites, and Docker
- Where it doesn't
- Limited to JSON REST contract files
- Requires self-hosted deployment and operation
- No built-in AI features
WSO2 Contract Test Runner fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update