- Home
- API Testing Tools
- Tavern
Tavern
What it is
Tavern is a free tool for developers who automate API tests using YAML. It works as a pytest plugin, command-line tool, and Python library, and its documentation recommends running it with pytest. Each YAML test has a name and one or more stages containing requests and expected responses. Checks can validate status codes, JSON bodies, headers, and redirect query parameters. Tavern supports RESTful APIs, MQTT-based APIs, gRPC services, and GraphQL through documented request backends. Tests can load variables from configuration files, reuse response values in later requests, and read environment variables for credentials such as passwords or bearer tokens. The default backends use requests for HTTP, paho-mqtt for MQTT, grpcio for gRPC, and gql for GraphQL. A plugin system can change request handling, with documented plugins for Flask and FastAPI/Starlette test clients. Tavern can run through tavern-ci or integrate into test frameworks and continuous integration through its Python library. The project began in 2017 and names @michaelboulton as its current maintainer. Its documented limits include no GUI, API monitoring, or mock servers.
For and against
For
- Supports REST, MQTT, gRPC, and GraphQL
- Checks status codes, JSON, headers, and redirects
- Can reuse response values in later stages
- Supports pytest and continuous integration setups
- Environment variables can keep credentials out of test code
Against
- Has no GUI
- Does not provide API monitoring
- Does not provide mock servers
The verdict
Tavern offers YAML-based testing across several API protocols, with pytest, command-line, and Python integration paths. Its lack of a GUI, monitoring, and mock servers makes its scope focused on test automation.
Who it suits
Tavern is for developers who want to automate API tests in YAML and integrate them with pytest or continuous integration. It may suit teams comfortable working through code and command-line tools rather than a GUI.
Plans and prices
Tavern
Free and open-source API test automation tool
Read 9 Oct 2026 · tavern.readthedocs.io
On the record
- Assertions
- Response checks can validate status codes, JSON bodies, headers, and redirect query parameters.tavern.readthedocs.io · read 9 Oct 2026
- Audience
- The project describes Tavern as a focused tool for developers to automate API tests.tavern.readthedocs.io · read 9 Oct 2026
- Backends
- The documented default backends use requests for HTTP, paho-mqtt for MQTT, grpcio for gRPC, and gql for GraphQL.tavern.readthedocs.io · read 9 Oct 2026
- CI use
- The project documentation says Tavern can be integrated into test frameworks or continuous integration setups through its Python library or the tavern-ci command-line tool.tavern.readthedocs.io · read 9 Oct 2026
- Community plugin
- The plugins page lists tavern-grpc-web as a community-maintained backend for unary gRPC-Web calls over HTTP.tavern.readthedocs.io · read 9 Oct 2026
- Development
- The changelog lists version 3.6.0, dated 2026-05-31, as the latest release shown.tavern.readthedocs.io · read 9 Oct 2026
- Extensibility
- Tavern has a plugin system for changing how requests are made, and its documentation names plugins for Flask and FastAPI/Starlette test clients.tavern.readthedocs.io · read 9 Oct 2026
- GraphQL
- The plugin documentation lists GraphQL as a built-in request backend.tavern.readthedocs.io · read 9 Oct 2026
- How to run
- The documentation recommends using Tavern with pytest; it can also be run through the tavern-ci command-line interface or integrated using its Python library.tavern.readthedocs.io · read 9 Oct 2026
- Integrations
- The documented default backends use requests for HTTP, paho-mqtt for MQTT, grpcio for gRPC, and gql for GraphQL.tavern.readthedocs.io · read 9 Oct 2026
- Limitations
- Tavern does not have a GUI, API monitoring, or mock servers, according to its comparison with Postman and Insomnia.tavern.readthedocs.io · read 9 Oct 2026
- Maintenance
- The documentation names @michaelboulton as the current maintainer.tavern.readthedocs.io · read 9 Oct 2026
- Notable limits
- Tavern has no GUI and does not provide API monitoring or mock servers.tavern.readthedocs.io · read 9 Oct 2026
- Project history
- The project says Tavern was started in 2017.tavern.readthedocs.io · read 9 Oct 2026
- Protocols
- Tavern supports testing RESTful APIs, MQTT-based APIs, and gRPC services.tavern.readthedocs.io · read 9 Oct 2026
- Purpose
- Tavern is a pytest plugin, command-line tool, and Python library for automated API testing using YAML syntax.tavern.readthedocs.io · read 9 Oct 2026
- Pytest
- The documentation recommends using Tavern with pytest, which can discover and run Tavern YAML test files.tavern.readthedocs.io · read 9 Oct 2026
- Response checks
- Response checks can include status codes, JSON, headers, and redirect query parameters.tavern.readthedocs.io · read 9 Oct 2026
