Published on

Getting Started with Wiremock


In this tutorial we will use docker to run an instance of wiremock to setup a mock api for us to test our api's.


Wiremock is a tool for building mock API's which enables us to build stable development environments.

Docker and Wiremock

Run a wiremock instance with docker:

docker run -it --rm -p 8080:8080 --name wiremock wiremock/wiremock:2.34.0

Then our wiremock instance will be exposed on port 8080 locally, which we can use to make a request against to create a api mapping:

curl -XPOST -H "Content-Type: application/json" \
  -d '{"request": {"url": "/testapi","method": "GET"}, "response": {"status": 200, "body": "{\"result\": \"ok\"
}", "headers": {"Content-Type": "application/json"}}}'

The response should be something like this:

    "id" : "223a2c0a-8b43-42dc-8ba6-fe973da1e420",
    "request" : {
      "url" : "/testapi",
      "method" : "GET"
    "response" : {
      "status" : 200,
      "body" : "{\"result\": \"ok\"}",
      "headers" : {
        "Content-Type" : "application/json"
    "uuid" : "223a2c0a-8b43-42dc-8ba6-fe973da1e420"

Test Wiremock

If we make a GET request against our API:

curl http://localhost:8080/testapi

Our response should be:

  "result": "ok"

Export Wiremock Mappings

We can export our mappings to a local file named stubs.json with:

curl -s http://localhost:8080/__admin/mappings --output stubs.json

Import Wiremock Mappings

We can import our mappings from our stubs.json file with:

curl -XPOST -v --data-binary @stubs.json http://localhost:8080/__admin/mappings/import


Thank You

Thanks for reading, feel free to check out my website, feel free to subscribe to my newsletter or follow me at @ruanbekker on Twitter.

Buy Me A Coffee