Schemathesis
Catch API bugs before your users do.
Schemathesis tests OpenAPI and GraphQL APIs by generating inputs from your schema, adapting to server responses, and chaining operations into realistic workflows.
Finding bugs that manual testing missed
Try it now
# Test a demo API - finds real bugs in 30 seconds
uvx schemathesis run https://example.schemathesis.io/openapi.json
# Test your own API
uvx schemathesis run https://your-api.com/openapi.json
What problems does it solve?
- 💥 500 errors that crash your API on edge case inputs
- 📋 Schema violations where your API returns different data than documented
- 🚪 Validation bypasses where invalid data gets accepted
- 🔗 Integration failures when responses don't match client expectations
- 🔄 Stateful bugs where operations work individually but fail in realistic workflows
⚠️ Upgrading from older versions? Check our Migration Guide for key changes.
Installation & Usage
Command Line:
uv pip install schemathesis
schemathesis run https://your-api.com/openapi.json
Python Tests:
import schemathesis
schema = schemathesis.openapi.from_url("https://your-api.com/openapi.json")
@schema.parametrize()
def test_api(case):
# Tests with random data, edge cases, and invalid inputs
case.call_and_validate()
# Stateful testing: Tests workflows like: create user -> get user -> delete user
APIWorkflow = schema.as_state_machine()
# Creates a test class for pytest/unittest
TestAPI = APIWorkflow.TestCase
CI/CD:
- uses: schemathesis/action@v3
with:
schema: "https://your-api.com/openapi.json"
Who uses it
Used by teams at Spotify, WordPress, JetBrains, Red Hat, and dozens of other companies.
"Schemathesis is the best tool for fuzz testing of REST APIs on the market. We at Red Hat use it for examining our applications in functional and integration testing levels." - Dmitry Misharov, RedHat
See it in action
🔬 Live Benchmarks showing continuous testing results from real-world APIs:
- Code & API schema coverage achieved
- Issues found with detailed categorization
- Performance across different fuzzing strategies
Reporting
- Allure — Rich visual reports with per-operation results, failure steps, and curl reproduction commands
- JUnit XML — For GitHub Actions, GitLab CI, Jenkins, and any CI tool that consumes JUnit
Documentation
📚 Documentation with guides, examples, and API reference.
Get Help
Contributing
We welcome contributions! See our contributing guidelines and join discussions in issues or Discord.
Acknowledgements
Schemathesis is built on top of Hypothesis, a powerful property-based testing library for Python.
License
This project is licensed under the terms of the MIT license.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file schemathesis-4.25.0.tar.gz.
File metadata
- Download URL: schemathesis-4.25.0.tar.gz
- Upload date:
- Size: 2.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
656b945fd3ec4fc13fbf9922be0bf2b75234d02067ae2c8b4d399bd3a5b8f8aa
|
|
| MD5 |
833367c7ef25f3b9156ddf335d907873
|
|
| BLAKE2b-256 |
c9e0bba6582674338e217d3f21b989dd761c90e613f115aa16c0801c8eb415b6
|
File details
Details for the file schemathesis-4.25.0-py3-none-any.whl.
File metadata
- Download URL: schemathesis-4.25.0-py3-none-any.whl
- Upload date:
- Size: 882.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e98adc7ccd8943cc76aeaf4117d62b2db9b12ff24c54ebe9c0c6340ae4d08b5e
|
|
| MD5 |
a4d49c56f2de8b4a722998d1743b4936
|
|
| BLAKE2b-256 |
417a08c28af467594d8262ae653ca69d5dd48a0b129146b73125a3d35d935864
|
