Using Mock API Templates

WARNING: This document is for an old WireMock 2.x baseline. See the documentation for the current WireMock 3.x baseline here

This guide explains how to run an API template after you’ve downloaded the JSON file from the library page.

WireMock standalone JAR #

  1. Create a folder called mappings if one doesn’t already exist in the directory containing the standalone JAR file.
  2. Copy the downloaded JSON file into the mappings directory then e.g.
  3. The JSON will be automatically loaded at startup, via the command line
java -jar wiremock-jre8-standalone-2.35.0.jar

See this page for general details on running WireMock standalone.

In WireMock Docker #

  1. Create a folder with a subfolder inside called mappings.
  2. Copy the JSON file into the mappings folder.
  3. Start the Docker container, mounting the parent folder e.g. assuming the current directory contains mappings:
docker run -it --rm \
  -p 8080:8080 \
  --name wiremock \
  -v $PWD:/home/wiremock \
  wiremock/wiremock:2.35.0

See this page for general details on running WireMock Docker.

Plain Java #

If you’re running WireMock embedded in a Java program or test suite you can place the JSON file in a folder called mappings then set its parent as the WireMock server’s root at startup.

WireMockServer wm =
  new WireMockServer(wireMockConfig()
    .withRootDirectory("path/to/root") // The parent folder of mappings
  );

See this for general details on running WireMock in embedded Java.

JUnit #

To do the same thing using the JUnit Jupiter extension:

@RegisterExtension
    static WireMockExtension wm1 = WireMockExtension.newInstance()
            .options(wireMockConfig().withRootDirectory("path/to/root"))
            .build();

See this for general details on running WireMock with JUnit 5+ Jupiter.

Pushing to a remotely running WireMock server #

The mock API JSON can be pushed to a remotely running WireMock server via its Admin API.

For instance if the WireMock server is running on wiremock.dev.mycompany.com port 8080, you can POST the JSON file to it e.g.

curl -v -d@mockapi.json http://wiremock.dev.mycompany.com:8080/__admin/mappings/import