Overview
WireMock is an API-mocking and service-virtualization tool that matches HTTP requests by URL, headers, body, and other properties and returns configured responses. It can run as a Java library, standalone server, or container and supports delays, faults, record/playback, request verification, and stateful behavior.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Stub HTTP responses from precise request conditions
URL, method, header, and body matching can drive configurable response status, headers, and body content.
Simulate latency, faults, and recorded upstream behavior
Delay and fault injection, traffic record/playback, proxying, and request verification support both normal and failure scenarios.
For stable integration and component tests around external APIs
WireMock fits tests that must proceed even when third-party services are unfinished, flaky, costly, or rate-limited.
Sources: [2]
Continuously validate mock behavior against the real service contract
Mocks can drift away from upstream APIs. Pair stubs with contract/OpenAPI validation or periodic real-endpoint tests so local behavior does not become stale.
Sources: [4]
Official sources
- [1]wiremock/wiremock repository(2026-09-20)
- [2]WireMock README(2026-09-20)
- [3]WireMock Apache-2.0 license(2026-09-20)
- [4]WireMock documentation(2026-09-20)
Supplemental curator note
WireMock helps keep tests deterministic when upstream APIs are unavailable, unstable, costly, or rate-limited by replacing them with controllable local HTTP behavior. The OSS project is Apache-2.0; advanced WireMock Cloud capabilities mentioned in the README are a separate service.
Try it in 3 steps
- 1
Start the standalone WireMock container
Start WireMock with the HTTP port exposed only on localhost.
docker run --name wiremock-demo --rm -d -p 127.0.0.1:8080:8080 wiremock/wiremock:latest - 2
Register a GET /hello stub
Use the Admin API to define one request matcher and deterministic response.
curl -sS -X POST http://127.0.0.1:8080/__admin/mappings -H 'Content-Type: application/json' -d '{"request":{"method":"GET","url":"/hello"},"response":{"status":200,"body":"hello"}}' - 3
Call the mocked endpoint
Verify that 200/hello is returned without a real upstream service.
curl -i http://127.0.0.1:8080/hello
Growth
Growth trends · Last 30 days
7,375 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 32
- Open PRs
- 71
- Issues opened
- 11
- Issues closed
- 3
- PRs opened
- 104
- PRs merged
- 59
Issues
11 / 3
Pull requests
104 / 59
Maintenance
- Median first response
- 9.1 days
- Issue response rate
- 9.1% (1/11)
Based on up to the 100 newest issues opened by external users in the last 90 days. A first comment from an OWNER, MEMBER, or COLLABORATOR counts as a response; issues whose full comment history cannot be checked are excluded. The median and response rate update weekly.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- wiremock
- json
- mocking
- stubbing
- java
- xml
- rest
- http
- apis
- mock-server
- hacktoberfest
- Stars
- 7,375
- Forks
- 1,518
- Watchers
- 133
- Open issues
- 431
- Contributors
- 247
- Primary language
- Java
- License
- Apache-2.0
- Repository last updated
- Sep 18, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Firecrawl182,282 Stars
A web scraping and crawling API that turns websites into LLM-ready data.
TypeScript - Axios109,205 Stars
A Promise-based HTTP client for browsers and Node.js with interceptors, adapters, cancellation, and transport controls.
JavaScript - FastAPI102,468 Stars
A Python web framework that derives validation, OpenAPI, and interactive API docs from type hints.
Python - Playwright96,362 Stars
A web automation platform spanning Chromium, Firefox, and WebKit E2E tests, scripts, a coding-agent CLI, and MCP through one API.
TypeScript - Storybook91,098 Stars
A frontend workshop that isolates UI components and reuses stories across development, Docs, interaction, visual, and accessibility testing.
TypeScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.