WireMock.Net is a flexible library for stubbing and mocking web HTTP responses using requests matching and response templating. Based on the functionality from http://WireMock.org, but extended with more functionality.
StefH Use RandomDataGenerator.Net (#231)
* Include="RandomDataGenerator.Net" Version="1.0.3"

* UndefinedBindingResult
Latest commit 18af7a4 Nov 13, 2018



A C# .NET version based on mock4net which mimics the functionality from the JAVA based WireMock.org.

Key Features

  • HTTP response stubbing, matchable on URL/Path, headers, cookies and body content patterns
  • Runs in unit tests, as a standalone process, as windows service, as Azure or IIS or as docker
  • Configurable via a fluent DotNet API, JSON files and JSON over HTTP
  • Record/playback of stubs
  • Per-request conditional proxying
  • Stateful behaviour simulation
  • Configurable response delays


  Chat Gitter
  Issues GitHub issues
  Build Azure Build Status Azure
  CodeFactor CodeFactor
  Sonar Quality Gate Sonar Quality Gate
  Sonar Bugs Sonar Bugs
  Sonar Code Smells Sonar Code Smells
  Sonar Coverage Sonar Coverage
  Codecov codecov
  Coveralls Coverage Status
  WireMock.Net NuGet Badge WireMock.Net
  WireMock.Net.StandAlone NuGet Badge WireMock.Net.StandAlone
MyGet (previews)  
  WireMock.Net MyGet Badge WireMock.Net
  WireMock.Net.StandAlone MyGet Badge WireMock.Net.StandAlone


For the supported frameworks and build information, see this page.


A core feature of WireMock.Net is the ability to return predefined HTTP responses for requests matching criteria. See Wiki : Stubbing.

Request Matching

WireMock.Net support advanced request-matching logic, see Wiki : Request Matching.

Response Templating

The response which is returned WireMock.Net can be changed using templating. This is described here Wiki : Response Templating.

Admin API Reference

The WireMock admin API provides functionality to define the mappings via a http interface see Wiki : Admin API Reference.


WireMock.Net can be used in several ways:


You can use your favorite test framework and use WireMock within your tests, see Wiki : UnitTesting.

As standalone process / console application

This is quite straight forward to launch a mock server within a console application, see Wiki : Standalone Process.

As a Windows Service

You can also run WireMock.Net as a Windows Service, follow this WireMock-as-a-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.


More details on using HTTPS (SSL) can be found here Wiki : HTTPS