WireMock.Net 2.30.0
WireMock.Net
Lightweight Http Mocking Server for .NET, inspired by WireMock.org (from the Java landscape).
:star: Key Features
- HTTP response stubbing, matchable on URL/Path, headers, cookies and body content patterns
- Library can be used in unit tests and integration tests
- Runs as a standalone process, as windows service, as Azure/IIS or as docker
- Configurable via a fluent C# .NET API, JSON files and JSON over HTTP
- Record/playback of stubs (proxying)
- Per-request conditional proxying
- Stateful behaviour simulation
- Response templating / transformation using Handlebars and extensions
- Can be used locally or in CI/CD scenarios
- Can be used for Aspire Distributed Application testing
:star: Stubbing
A core feature of WireMock.Net is the ability to return predefined HTTP responses for requests matching criteria. See Stubbing.
:star: Request Matching
WireMock.Net support advanced request-matching logic, see Request Matching.
:star: Response Templating
The response which is returned WireMock.Net can be changed using templating. This is described here Response Templating.
:star: Admin API Reference
The WireMock admin API provides functionality to define the mappings via a http interface see Admin API Reference.
:star: Using
WireMock.Net can be used in several ways:
UnitTesting
You can use your favorite test framework and use WireMock within your tests, see UnitTesting.
Unit/Integration Testing using Testcontainers.DotNet
See WireMock.Net.Testcontainers on how to build a WireMock.Net Docker container which can be used in Unit/Integration testing.
Unit/Integration Testing using an an Aspire Distributed Application
See WireMock.Net.Aspire on how to use WireMock.Net as an Aspire Hosted application to do Unit/Integration testing.
As a dotnet tool
It's simple to install WireMock.Net as (global) dotnet tool, see dotnet tool.
As standalone process / console application
This is quite straight forward to launch a mock server within a console application, see Standalone Process.
As a Windows Service
You can also run WireMock.Net as a Windows Service, follow this Windows Service.
As a Web Job in Azure or application in IIS
See this link WireMock-as-a-(Azure)-Web-App
In a docker container
There is also a Linux and Windows-Nano container available at hub.docker.com. For more details see also Docker.
HTTPS / SSL
More details on using HTTPS (SSL) can be found here HTTPS
:books: Documentation
For more info, see also this documentation page: What is WireMock.Net.
No packages depend on WireMock.Net.
2.30.0 (07 November 2026)
- #1527 Publish standalone single-file binaries in GitHub Releases [feature]
- #1528 Add .NET 10 target framework [feature]
- #1530 Use 10.x.x NuGets for .NET 10 [dependencies]
- #1532 Switch to IHost for .NET 10 + update dotnet-WireMock [feature]
The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md
.NET 10.0
- WireMock.Net.GraphQL (>= 2.30.0)
- WireMock.Net.Matchers.SystemTextJsonPath (>= 2.30.0)
- WireMock.Net.MimePart (>= 2.30.0)
- WireMock.Net.Minimal (>= 2.30.0)
- WireMock.Net.OpenTelemetry (>= 2.30.0)
- WireMock.Net.ProtoBuf (>= 2.30.0)
.NET Framework 4.6.2
- WireMock.Net.GraphQL (>= 2.30.0)
- WireMock.Net.Matchers.SystemTextJsonPath (>= 2.30.0)
- WireMock.Net.MimePart (>= 2.30.0)
- WireMock.Net.Minimal (>= 2.30.0)
- WireMock.Net.OpenTelemetry (>= 2.30.0)
- WireMock.Net.ProtoBuf (>= 2.30.0)
.NET 8.0
- WireMock.Net.GraphQL (>= 2.30.0)
- WireMock.Net.Matchers.SystemTextJsonPath (>= 2.30.0)
- WireMock.Net.MimePart (>= 2.30.0)
- WireMock.Net.Minimal (>= 2.30.0)
- WireMock.Net.OpenTelemetry (>= 2.30.0)
- WireMock.Net.ProtoBuf (>= 2.30.0)
.NET Standard 2.1
- WireMock.Net.GraphQL (>= 2.30.0)
- WireMock.Net.Matchers.SystemTextJsonPath (>= 2.30.0)
- WireMock.Net.MimePart (>= 2.30.0)
- WireMock.Net.Minimal (>= 2.30.0)
- WireMock.Net.OpenTelemetry (>= 2.30.0)
- WireMock.Net.ProtoBuf (>= 2.30.0)
| Version | Downloads | Last updated |
|---|---|---|
| 2.30.0 | 1 | 11/07/2026 |
| 2.21.0 | 4 | 10/29/2026 |
| 2.20.0 | 6 | 10/24/2026 |
| 2.19.0 | 25 | 10/09/2026 |
| 2.18.0 | 26 | 10/01/2026 |
| 2.17.0 | 25 | 09/30/2026 |
| 2.16.0 | 26 | 10/01/2026 |
| 2.15.0 | 21 | 10/01/2026 |
| 2.14.0 | 22 | 10/01/2026 |
| 2.13.0 | 25 | 10/01/2026 |
| 2.12.0 | 22 | 10/01/2026 |
| 2.11.0 | 19 | 10/02/2026 |
| 2.10.0 | 26 | 10/01/2026 |
| 2.9.0 | 19 | 10/01/2026 |
| 2.8.0 | 23 | 10/01/2026 |
| 2.7.0 | 26 | 10/01/2026 |
| 2.6.0 | 22 | 10/01/2026 |
| 2.5.0 | 27 | 10/01/2026 |
| 2.4.0 | 25 | 10/01/2026 |
| 2.3.0 | 23 | 10/01/2026 |
| 2.2.0 | 24 | 10/01/2026 |
| 2.1.0 | 23 | 10/01/2026 |
| 2.0.0 | 23 | 10/01/2026 |
| 1.25.0 | 22 | 10/01/2026 |
| 1.24.0 | 23 | 10/01/2026 |
| 1.23.0 | 23 | 10/01/2026 |
| 1.22.0 | 24 | 10/01/2026 |
| 1.21.0 | 20 | 10/01/2026 |
| 1.20.0 | 24 | 10/01/2026 |
| 1.19.0 | 24 | 10/01/2026 |
| 1.18.0 | 24 | 10/01/2026 |
| 1.17.0 | 20 | 10/01/2026 |
| 1.16.0 | 22 | 10/01/2026 |
| 1.15.0 | 17 | 10/01/2026 |
| 1.14.0 | 25 | 10/01/2026 |
| 1.14.0-preview-01 | 22 | 10/02/2026 |
| 1.13.0 | 22 | 10/01/2026 |
| 1.12.0 | 23 | 10/01/2026 |
| 1.11.2 | 24 | 10/01/2026 |
| 1.11.1 | 20 | 10/01/2026 |
| 1.11.0 | 24 | 10/01/2026 |
| 1.10.1 | 17 | 10/01/2026 |
| 1.10.0 | 22 | 10/01/2026 |
| 1.9.1 | 22 | 10/01/2026 |
| 1.9.0 | 25 | 10/01/2026 |
| 1.8.18 | 20 | 10/01/2026 |
| 1.8.17 | 26 | 10/01/2026 |
| 1.8.16 | 23 | 10/01/2026 |
| 1.8.15 | 28 | 10/01/2026 |
| 1.8.14 | 20 | 10/01/2026 |
| 1.8.13 | 21 | 10/01/2026 |
| 1.8.13-preview-02 | 22 | 10/01/2026 |
| 1.8.13-preview-01 | 22 | 10/02/2026 |
| 1.8.12 | 24 | 10/01/2026 |
| 1.8.11 | 25 | 10/01/2026 |
| 1.8.10 | 23 | 10/01/2026 |
| 1.8.9 | 20 | 10/01/2026 |
| 1.8.8 | 21 | 10/01/2026 |
| 1.8.7 | 43 | 10/01/2026 |
| 1.8.6 | 21 | 10/01/2026 |
| 1.8.5 | 19 | 10/01/2026 |
| 1.8.4 | 24 | 10/01/2026 |
| 1.8.3 | 24 | 10/01/2026 |
| 1.8.2 | 29 | 10/01/2026 |
| 1.8.1 | 20 | 10/01/2026 |
| 1.8.0 | 30 | 10/01/2026 |
| 1.8.0-prview-01 | 32 | 10/01/2026 |
| 1.7.5-preview-02 | 19 | 10/02/2026 |
| 1.7.5-preview-01 | 19 | 10/02/2026 |
| 1.7.4 | 20 | 10/01/2026 |
| 1.7.3 | 25 | 10/01/2026 |
| 1.7.2 | 21 | 10/01/2026 |
| 1.7.2-preview-01 | 16 | 10/02/2026 |
| 1.7.1 | 21 | 10/01/2026 |
| 1.7.0 | 29 | 10/01/2026 |
| 1.6.12 | 26 | 10/01/2026 |
| 1.6.11 | 25 | 10/01/2026 |
| 1.6.10 | 31 | 10/01/2026 |
| 1.6.9 | 24 | 10/01/2026 |
| 1.6.8 | 24 | 10/01/2026 |
| 1.6.7 | 21 | 10/01/2026 |
| 1.6.7-preview-02 | 22 | 10/02/2026 |
| 1.6.7-preview-01 | 19 | 10/02/2026 |
| 1.6.6 | 22 | 10/01/2026 |
| 1.6.5 | 23 | 10/01/2026 |
| 1.6.4 | 24 | 10/01/2026 |
| 1.6.3 | 19 | 10/01/2026 |
| 1.6.2 | 23 | 10/01/2026 |
| 1.6.1 | 20 | 10/01/2026 |
| 1.6.0 | 17 | 10/01/2026 |
| 1.5.62 | 22 | 10/01/2026 |
| 1.5.61 | 24 | 10/01/2026 |
| 1.5.60 | 24 | 10/01/2026 |
| 1.5.59 | 24 | 10/01/2026 |
| 1.5.58 | 21 | 10/01/2026 |
| 1.5.57 | 22 | 10/01/2026 |
| 1.5.56 | 23 | 10/01/2026 |
| 1.5.55 | 24 | 10/01/2026 |
| 1.5.54 | 20 | 10/01/2026 |
| 1.5.53 | 21 | 10/01/2026 |
| 1.5.52 | 22 | 10/01/2026 |
| 1.5.51 | 23 | 10/01/2026 |
| 1.5.50 | 20 | 10/02/2026 |
| 1.5.49 | 30 | 10/01/2026 |
| 1.5.48 | 22 | 10/01/2026 |
| 1.5.47 | 22 | 10/01/2026 |
| 1.5.46 | 32 | 10/01/2026 |
| 1.5.45 | 25 | 10/01/2026 |
| 1.5.44 | 27 | 10/01/2026 |
| 1.5.43 | 20 | 10/01/2026 |
| 1.5.42 | 26 | 10/01/2026 |
| 1.5.41 | 20 | 10/01/2026 |
| 1.5.40 | 23 | 10/01/2026 |
| 1.5.39 | 25 | 10/01/2026 |
| 1.5.38 | 21 | 10/01/2026 |
| 1.5.37 | 28 | 10/01/2026 |
| 1.5.36 | 21 | 10/01/2026 |
| 1.5.35 | 23 | 10/01/2026 |
| 1.5.34 | 22 | 10/01/2026 |
| 1.5.32 | 23 | 10/01/2026 |
| 1.5.31 | 24 | 10/01/2026 |
| 1.5.30 | 23 | 10/01/2026 |
| 1.5.29 | 20 | 10/01/2026 |
| 1.5.28 | 25 | 10/01/2026 |
| 1.5.27 | 24 | 10/01/2026 |
| 1.5.26 | 18 | 10/01/2026 |
| 1.5.25 | 21 | 10/01/2026 |
| 1.5.24 | 24 | 10/01/2026 |
| 1.5.23 | 25 | 10/01/2026 |
| 1.5.22 | 21 | 10/01/2026 |
| 1.5.21 | 27 | 10/01/2026 |
| 1.5.20 | 30 | 10/01/2026 |
| 1.5.19 | 23 | 10/01/2026 |
| 1.5.18 | 20 | 10/01/2026 |
| 1.5.17 | 24 | 10/01/2026 |
| 1.5.16 | 22 | 10/01/2026 |
| 1.5.15 | 22 | 10/01/2026 |
| 1.5.14 | 24 | 10/01/2026 |
| 1.5.13 | 22 | 10/01/2026 |
| 1.5.12 | 20 | 10/01/2026 |
| 1.5.11 | 18 | 10/01/2026 |
| 1.5.10 | 19 | 10/01/2026 |
| 1.5.9 | 21 | 10/01/2026 |
| 1.5.8 | 22 | 10/01/2026 |
| 1.5.7 | 24 | 10/01/2026 |
| 1.5.6 | 19 | 10/01/2026 |
| 1.5.5 | 18 | 10/01/2026 |
| 1.5.4 | 28 | 10/01/2026 |
| 1.5.3 | 31 | 10/01/2026 |
| 1.5.2 | 26 | 10/01/2026 |
| 1.5.1 | 23 | 10/01/2026 |
| 1.5.0 | 30 | 10/01/2026 |
| 1.4.43 | 22 | 10/01/2026 |
| 1.4.42 | 19 | 10/01/2026 |
| 1.4.41 | 19 | 10/01/2026 |
| 1.4.40 | 25 | 10/01/2026 |
| 1.4.39 | 26 | 10/02/2026 |
| 1.4.38 | 21 | 10/01/2026 |
| 1.4.37 | 22 | 10/01/2026 |
| 1.4.36 | 16 | 10/01/2026 |
| 1.4.35 | 22 | 10/01/2026 |
| 1.4.34 | 21 | 10/01/2026 |
| 1.4.33 | 25 | 10/01/2026 |
| 1.4.32 | 22 | 10/01/2026 |
| 1.4.31 | 20 | 10/01/2026 |
| 1.4.30 | 29 | 10/01/2026 |
| 1.4.29 | 24 | 10/01/2026 |
| 1.4.28 | 23 | 10/01/2026 |
| 1.4.27 | 20 | 10/01/2026 |
| 1.4.26 | 19 | 10/01/2026 |
| 1.4.25 | 23 | 10/01/2026 |
| 1.4.24 | 21 | 10/01/2026 |
| 1.4.23 | 25 | 10/01/2026 |
| 1.4.22 | 25 | 10/01/2026 |
| 1.4.21 | 25 | 10/01/2026 |
| 1.4.20 | 21 | 10/01/2026 |
| 1.4.19 | 22 | 10/02/2026 |
| 1.4.18 | 24 | 10/01/2026 |
| 1.4.17 | 21 | 10/01/2026 |
| 1.4.16 | 18 | 10/01/2026 |
| 1.4.15 | 22 | 10/01/2026 |
| 1.4.14 | 23 | 10/01/2026 |
| 1.4.13 | 23 | 10/01/2026 |
| 1.4.12 | 22 | 10/01/2026 |
| 1.4.11 | 24 | 10/01/2026 |
| 1.4.10 | 24 | 10/01/2026 |
| 1.4.9 | 23 | 10/01/2026 |
| 1.4.8 | 22 | 10/01/2026 |
| 1.4.7 | 25 | 10/01/2026 |
| 1.4.6 | 20 | 10/01/2026 |
| 1.4.5 | 19 | 10/01/2026 |
| 1.4.4 | 21 | 10/01/2026 |
| 1.4.3 | 26 | 10/01/2026 |
| 1.4.2 | 24 | 10/01/2026 |
| 1.4.1 | 20 | 10/01/2026 |
| 1.4.0 | 20 | 10/01/2026 |
| 1.3.10 | 21 | 10/01/2026 |
| 1.3.9 | 21 | 10/01/2026 |
| 1.3.8 | 23 | 10/01/2026 |
| 1.3.7 | 21 | 10/01/2026 |
| 1.3.6 | 24 | 10/01/2026 |
| 1.3.5 | 24 | 10/01/2026 |
| 1.3.4 | 23 | 10/01/2026 |
| 1.3.3 | 24 | 10/01/2026 |
| 1.3.2 | 24 | 10/01/2026 |
| 1.3.1 | 24 | 10/01/2026 |
| 1.3.0 | 23 | 10/01/2026 |
| 1.2.18 | 22 | 10/01/2026 |
| 1.2.17 | 24 | 10/01/2026 |
| 1.2.16 | 22 | 10/01/2026 |
| 1.2.15 | 24 | 10/01/2026 |
| 1.2.14 | 24 | 10/01/2026 |
| 1.2.13 | 21 | 10/01/2026 |
| 1.2.12 | 24 | 10/01/2026 |
| 1.2.11 | 21 | 10/01/2026 |
| 1.2.10 | 18 | 10/01/2026 |
| 1.2.9 | 27 | 10/01/2026 |
| 1.2.8 | 21 | 10/01/2026 |
| 1.2.7 | 22 | 10/01/2026 |
| 1.2.6 | 26 | 10/01/2026 |
| 1.2.5 | 21 | 10/01/2026 |
| 1.2.4 | 26 | 10/01/2026 |
| 1.2.3 | 21 | 10/01/2026 |
| 1.2.2 | 23 | 10/01/2026 |
| 1.2.1 | 25 | 10/01/2026 |
| 1.2.0 | 22 | 10/01/2026 |
| 1.1.10 | 22 | 10/01/2026 |
| 1.1.9 | 23 | 10/01/2026 |
| 1.1.8 | 20 | 10/01/2026 |
| 1.1.7 | 23 | 10/01/2026 |
| 1.1.6 | 23 | 10/01/2026 |
| 1.1.5 | 24 | 10/01/2026 |
| 1.1.4 | 22 | 10/01/2026 |
| 1.1.3 | 22 | 10/01/2026 |
| 1.1.2 | 24 | 10/01/2026 |
| 1.1.1 | 26 | 10/01/2026 |
| 1.1.0 | 24 | 10/01/2026 |
| 1.0.43 | 24 | 10/01/2026 |
| 1.0.42 | 20 | 10/01/2026 |
| 1.0.41 | 24 | 10/01/2026 |
| 1.0.40 | 26 | 10/01/2026 |
| 1.0.39 | 15 | 10/01/2026 |
| 1.0.38 | 21 | 10/01/2026 |
| 1.0.37 | 24 | 10/01/2026 |
| 1.0.36 | 24 | 10/01/2026 |
| 1.0.36-ci-12100 | 20 | 10/01/2026 |
| 1.0.35 | 22 | 10/01/2026 |
| 1.0.34 | 24 | 10/01/2026 |
| 1.0.33 | 21 | 10/01/2026 |
| 1.0.32 | 19 | 10/01/2026 |
| 1.0.31 | 23 | 10/01/2026 |
| 1.0.30 | 22 | 10/01/2026 |
| 1.0.29 | 25 | 10/01/2026 |
| 1.0.28 | 20 | 10/01/2026 |
| 1.0.27 | 22 | 10/01/2026 |
| 1.0.26 | 23 | 10/01/2026 |
| 1.0.25 | 24 | 10/01/2026 |
| 1.0.24 | 22 | 10/01/2026 |
| 1.0.23 | 21 | 10/01/2026 |
| 1.0.22 | 24 | 10/01/2026 |
| 1.0.20 | 22 | 10/01/2026 |
| 1.0.19 | 22 | 10/01/2026 |
| 1.0.18 | 23 | 10/01/2026 |
| 1.0.17 | 20 | 10/01/2026 |
| 1.0.16 | 20 | 10/01/2026 |
| 1.0.15 | 23 | 10/01/2026 |
| 1.0.14 | 22 | 10/01/2026 |
| 1.0.13 | 25 | 10/01/2026 |
| 1.0.12 | 24 | 10/01/2026 |
| 1.0.11 | 24 | 10/01/2026 |
| 1.0.10 | 23 | 10/01/2026 |
| 1.0.9 | 28 | 10/01/2026 |
| 1.0.8 | 23 | 10/01/2026 |
| 1.0.7 | 21 | 10/01/2026 |
| 1.0.6.1 | 20 | 10/01/2026 |
| 1.0.6 | 20 | 10/01/2026 |
| 1.0.5 | 23 | 10/01/2026 |
| 1.0.4.21 | 23 | 10/01/2026 |
| 1.0.4.20 | 26 | 10/01/2026 |
| 1.0.4.19 | 26 | 10/01/2026 |
| 1.0.4.18 | 25 | 10/01/2026 |
| 1.0.4.17 | 23 | 10/01/2026 |
| 1.0.4.16 | 25 | 10/01/2026 |
| 1.0.4.15 | 24 | 10/01/2026 |
| 1.0.4.14 | 23 | 10/01/2026 |
| 1.0.4.13 | 21 | 10/01/2026 |
| 1.0.4.12 | 22 | 10/01/2026 |
| 1.0.4.11 | 21 | 10/01/2026 |
| 1.0.4.10 | 23 | 10/01/2026 |
| 1.0.4.9 | 22 | 10/01/2026 |
| 1.0.4.8 | 22 | 10/01/2026 |
| 1.0.4.7 | 20 | 10/01/2026 |
| 1.0.4.6 | 23 | 10/01/2026 |
| 1.0.4.5 | 23 | 10/01/2026 |
| 1.0.4.4 | 23 | 10/01/2026 |
| 1.0.4.3 | 22 | 10/01/2026 |
| 1.0.4.2 | 22 | 10/01/2026 |
| 1.0.4.1 | 20 | 10/01/2026 |
| 1.0.4 | 26 | 10/01/2026 |
| 1.0.3.20 | 24 | 10/01/2026 |
| 1.0.3.19 | 22 | 10/01/2026 |
| 1.0.3.18 | 22 | 10/01/2026 |
| 1.0.3.17 | 20 | 10/01/2026 |
| 1.0.3.16 | 28 | 10/01/2026 |
| 1.0.3.15 | 26 | 10/01/2026 |
| 1.0.3.14 | 24 | 10/01/2026 |
| 1.0.3.13 | 21 | 10/01/2026 |
| 1.0.3.11 | 22 | 10/01/2026 |
| 1.0.3.10 | 21 | 10/01/2026 |
| 1.0.3.9 | 21 | 10/01/2026 |
| 1.0.3.8 | 23 | 10/01/2026 |
| 1.0.3.7 | 24 | 10/01/2026 |
| 1.0.3.6 | 22 | 10/01/2026 |
| 1.0.3.5 | 20 | 10/01/2026 |
| 1.0.3.4 | 22 | 10/01/2026 |
| 1.0.3.3 | 23 | 10/01/2026 |
| 1.0.3.2 | 22 | 10/01/2026 |
| 1.0.3.1 | 18 | 10/01/2026 |
| 1.0.3 | 23 | 10/01/2026 |
| 1.0.2.13 | 21 | 10/01/2026 |
| 1.0.2.12 | 25 | 10/01/2026 |
| 1.0.2.11 | 24 | 10/01/2026 |
| 1.0.2.10 | 22 | 10/01/2026 |
| 1.0.2.9 | 29 | 10/01/2026 |
| 1.0.2.8 | 22 | 10/01/2026 |
| 1.0.2.7 | 23 | 10/01/2026 |
| 1.0.2.6 | 24 | 10/01/2026 |
| 1.0.2.5 | 20 | 10/01/2026 |
| 1.0.2.4 | 18 | 10/01/2026 |
| 1.0.2.4-preview-02 | 22 | 10/02/2026 |
| 1.0.2.4-preview-01 | 20 | 10/02/2026 |
| 1.0.2.3 | 22 | 10/01/2026 |
| 1.0.2.3-preview2-final-03 | 20 | 10/02/2026 |
| 1.0.2.3-preview2-final-02 | 21 | 10/01/2026 |
| 1.0.2.3-preview2-final-01 | 20 | 10/02/2026 |
| 1.0.2.1 | 24 | 10/01/2026 |
| 1.0.2 | 23 | 10/01/2026 |
| 1.0.1.5 | 22 | 10/01/2026 |
| 1.0.1.4 | 23 | 10/01/2026 |
| 1.0.1.2 | 25 | 10/01/2026 |
| 1.0.1.1 | 22 | 10/01/2026 |
| 1.0.0 | 25 | 10/01/2026 |