Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Imposter

imposter.sh

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.4 Club score Visit imposter.sh

What Imposter is

Imposter is a free, open-source tool for developers and QA teams building interactive mock systems. It can turn OpenAPI files, WSDL files, or REST endpoints into mock APIs, with documented support for REST, OpenAPI/Swagger, SOAP/WSDL, HBase, Salesforce, and WireMock mappings. Mocks can run as standalone servers in Docker, Kubernetes, AWS Lambda, or on the JVM, or be embedded in JVM and Node.js tests. Responses may use static files or vary with incoming requests through JavaScript, Groovy, Java, or custom JVM-language plugins. The OpenAPI plugin validates request parameters, headers, and bodies against a specification. Imposter can capture request data for later retrieval or templated responses and proxy an existing endpoint to replay replies. Documentation covers GitHub Actions, GitLab CI, CircleCI, Jenkins, and Azure Pipelines. HTTPS with TLS and request authentication are configurable. The core Docker image includes OpenAPI, REST, and SOAP plugins; an all image includes every plugin and more dependencies.

Who it suits

Imposter suits API developers and QA teams that need mocks while decoupling integration tests from cloud or backend systems. It also fits teams embedding mocks in JVM or Node.js tests and CI/CD workflows.

Good to know, and what to watch

  • Creates mocks from OpenAPI, WSDL, or REST endpoints
  • Runs in Docker, Kubernetes, Lambda, or JVM
  • Supports request-dependent scripted responses
  • Validates OpenAPI request data
  • Works with common CI/CD platforms
  • The all Docker image has more dependencies
  • Shell-script installation targets macOS and Linux
  • Mock behavior may require JavaScript, Groovy, or Java

The verdict

Imposter covers mock creation, validation, proxying, and test integration across several deployment modes. Its plugin choices and scripting support give teams control, while image selection affects dependencies.

What the maker publishes

API validation and proxying
It can validate requests against an OpenAPI specification and proxy an existing endpoint to replay its responses as a mock. source
Audience
The maker presents Imposter for developers, including API developers, and highlights development and QA use cases. source
CI/CD
The getting started guide describes using Imposter in GitHub Actions and other CI/CD platforms, including GitLab CI, CircleCI, Jenkins, and Azure Pipelines. source
Data capture and proxying
Imposter can capture request data for later retrieval or templated responses, and proxy an existing endpoint to replay its responses as a mock. source
Distribution limit
The Docker documentation says the core image includes OpenAPI, REST, and SOAP plugins, while the all image contains all plugins and has the most dependencies. source
Dynamic responses
Mock responses can use static files or request-dependent behavior, with scripting in JavaScript, Groovy, or Java and custom plugins in JVM languages. source
Dynamic responses
Responses can use static files or be scripted with JavaScript, Groovy, or Java; advanced users can write plugins in JVM languages. source
Integrations
The maker documents JVM test bindings, JavaScript/Node.js test bindings, a Docker container, AWS Lambda, and GitHub Actions as ways to use or run Imposter. source
Integrations
The CLI documentation describes embedding Imposter in JVM and Node.js tests, and using GitHub Actions or other CI/CD platforms including GitLab, CircleCI, Jenkins, Azure Pipelines, and Bitbucket. source
Intended users
The maker describes Imposter as a tool for developers and QA, including teams that want to decouple integration tests from cloud or backend systems. source
Maker
The linked Gatehill site identifies Pete Cornish as the person who builds tools under the Gatehill name. source
Platform support
The CLI install page says its shell-script installation is for macOS and Linux; the CLI also supports native binary and Docker engines. source
Pricing
The opened maker pages describe the project and its downloads but do not state a price or subscription plan. source
Purpose
Imposter runs interactive mock systems and turns OpenAPI files, WSDL files, or REST endpoints into mock APIs for development or QA. source
Purpose
Imposter runs interactive mock systems for development and QA, including before a real API is available. source
Request data
Imposter can capture request data for later retrieval or use it in templates to create conditional responses. source
Request validation
The OpenAPI plugin can validate incoming request parameters, headers, and bodies against the specification. source
Run modes
Imposter can run as a standalone server in Docker, Kubernetes, AWS Lambda, or on the JVM, or be embedded in JVM and Node.js tests. source
Security
The security guide describes enabling HTTPS with TLS and configuring request authentication using headers, query parameters, or form parameters. source
Security
Imposter supports HTTPS through TLS configuration and can authenticate incoming HTTP requests using configured request conditions such as header values. source
Supported APIs
The documentation lists mock support for REST, OpenAPI/Swagger, SOAP/WSDL, HBase, Salesforce, and WireMock mappings. source
Supported mocks
It supports REST, OpenAPI/Swagger, SOAP/WSDL, HBase, Salesforce, and WireMock mappings. source
Telemetry
The feature documentation lists metrics collection and persistent or semi-persistent stores as configurable features. source
Ways to run
You can run standalone mocks in Docker, Kubernetes, AWS Lambda, or on the JVM, or embed them in JVM and Node.js tests. source

Checked against the maker's pages on 4 Oct 2026.