Suggestions appear as you type. Use the up and down arrows to choose one and Enter to open it.

WSO2 Contract Test Runner

Free#12 of 22 in Contract Testing ToolsJavaScript Testing Frameworks

WSO2 Contract Test Runner: A focused self-hosted runner for detailed JSON REST contract assertions. Ranked #12 of 22 in Contract Testing Tools by our editors (8.0/10); pricing: Open source; best for REST teams wanting detailed JSON assertions.

8.0/10Editor score
WSO2 Contract Test Runner8.0 Visit WSO2

At a glance

  • Editor score
    8.0 / 10
  • Pricing
    Open source
  • Best for
    REST teams wanting detailed JSON assertions
  • Paid from
    Free
  • Facts checked
    20 Sep 2026
WSO2 Contract Test Runner screenshot
  • 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

Our verdict on WSO2 Contract Test Runner

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.

Your product? Our editors can test WSO2 Contract Test Runner in depth and publish a review, labelled as paid · from $149/mo →

WSO2 Contract Test Runner pricing

Plans Open sourceFree Free to use — no paid tier required for the core job.
See plans on github.com

WSO2 Contract Test Runner fact sheet

Free planNot verified
Paid fromFree
Contract formatsJSON
Consumer verificationYes
Provider verificationYes
Contract registryNot verified
AsyncAPI supportNot verified
GraphQL supportNot verified
Self-hosted deploymentYes
DeploymentSelf-hosted
SupportCommunity, Docs
Built forSmall business, Mid-market, Enterprise (editorial estimate)
PricingOpen source
Websitegithub.com
Facts checked20 Sep 2026

Alternatives to WSO2 Contract Test Runner

See all WSO2 Contract Test Runner alternatives →

Also Ranked In

WSO2 Contract Test Runner is ranked in 2 of our directories.

Used WSO2 Contract Test Runner? Be the first to review it

The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used WSO2 Contract Test Runner for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.

Write a reviewTwo minutes · verified accounts only · read by an editor before it appears

Reviews come only from verified accounts. Sign in or create an account first — your e-mail is never shown.

Your rating

0 characters · at least 80, up to 3,000

Posted from your verified account. Reviews appear after an editor reads them, usually within two working days.

Featured on iTechGuides

Featured on iTechGuides — WSO2 Contract Test Runner 8.0/10

WSO2 Contract Test Runner is listed in our Contract Testing Tools directory. Add the badge to your site — it links back to this page.

<a href="https://www.itechguides.com/products/wso2-contract-test-runner/"><img src="https://www.itechguides.com/best/badge/wso2-contract-test-runner.svg" alt="Featured on iTechGuides" width="230" height="46"></a>

Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026

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