Need help with openapi-mock?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

239 Stars 36 Forks MIT License 299 Commits 8 Opened issues


OpenAPI mock server with random data generation

Services available


Need anything else?

Contributors list

OpenAPI Mock Server

CI Scrutinizer Code Quality Code Coverage GitHub release (latest by date)

OpenAPI API mock server with random data generation by specified schemas.

  • OpenAPI 3.x support.
  • Load specification from a local file or URL.
  • JSON and YAML format supported.
  • Generates fake response data by provided schemas or by examples.
  • Content negotiation by Accept header.
  • Can be used as standalone application (Linux and Windows) or can be run via Docker container.

Supported features

| Feature | Support status | | --- | --- | | generating xml response | basic support (without xml tags) | | generating json response | supported | | generation of basic types | supported | | generation of enums | supported | | generation of associative arrays | supported | | generation of combined types | supported (without tag

and discriminator) | | local reference resolving | supported | | remote reference resolving | not supported | | URL reference resolving | not supported | | validating request data | not supported | | force using custom response schema | not supported (schema detected automatically) |

Quick start

Download latest binary and run a server.

# runs a local server on port 8080
./openapi-mock serve --specification-url

to test that the server successfully ran

curl 'http://localhost:8080/v1/pets'

Alternatively, you can use Docker image.

# downloads an image
docker pull muonsoft/openapi-mock

runs a docker container with exported port 8080

docker run -p 8080:8080 -e "OPENAPI_MOCK_SPECIFICATION_URL=" --rm muonsoft/openapi-mock

to test that the server successfully ran

curl 'http://localhost:8080/v1/pets'

Also, you can use Docker Compose. Example of

version: '3.0'

services: openapi_mock: container_name: openapi_mock image: muonsoft/openapi-mock environment: OPENAPI_MOCK_SPECIFICATION_URL: '' ports: - "8080:8080"

To start up a container run command.

docker-compose up -d

Usage guide


This project is licensed under the MIT License - see the LICENSE file for details.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.