Schemathesis
schemathesis.io
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What Schemathesis is
Schemathesis generates API tests from OpenAPI and GraphQL schemas to help engineers find bugs. Its property-based cases probe boundary values, type mismatches, and constraint violations, then validate responses against the OpenAPI specification. Stateful tests can chain operations into multi-step workflows using links inferred from the schema. During a run, Schemathesis learns from server responses and can reuse validation rules, resource IDs, and authentication requirements. Engineers can add Python checks for business rules alongside built-in checks. It supports OpenAPI 2.0, 3.0, 3.1, and 3.2, as well as GraphQL schemas. Authentication options include Bearer tokens, Basic authentication, and API keys, with environment-variable substitution and Python hooks for dynamic flows. Integrations include GitHub Actions, Docker, pip or uvx installation, and pytest. Reports can be exported in JUnit, VCR, HAR, NDJSON, JSON, and Allure formats; failures can be saved with curl commands for replay. It is free, MIT-licensed, and self-hosted.
Who it suits
Schemathesis suits engineers testing APIs described with OpenAPI or GraphQL schemas. It is also aimed at teams integrating API tests into CI/CD.
Good to know, and what to watch
- Tests OpenAPI and GraphQL APIs.
- Validates responses against the OpenAPI specification.
- Chains API operations into multi-step workflows.
- Integrates with GitHub Actions, Docker, and pytest.
- Exports reports in six listed formats.
- The tool is self-hosted.
- Custom business-rule checks require Python.
- Technical support is directed through Discord.
Plans
Every plan and priceSchemathesis
Free plan
The verdict
Schemathesis covers schema-based API testing, stateful workflows, custom checks, and CI/CD integrations without a listed price. Teams should be comfortable running a self-hosted tool and using Python for custom business rules.
What the maker publishes
- Adaptive testing
- During a run, it learns from server responses and reuses discovered validation rules, resource IDs, and authentication requirements. source
- Authentication
- It supports Bearer tokens, Basic authentication, and API keys, with environment variable substitution and Python hooks for dynamic flows. source
- Custom checks
- Users can add Python checks for business rules alongside built-in checks. source
- Integrations
- The maker lists a GitHub Action, Docker image, pip or uvx installation, and pytest integration. source
- Intended users
- The maker presents Schemathesis for engineers testing OpenAPI or GraphQL APIs and integrating API tests into CI/CD. source
- License
- The project repository states that Schemathesis is licensed under the MIT license. source
- Purpose
- Schemathesis generates property-based tests from OpenAPI and GraphQL schemas to find API bugs. source
- Reports
- It can export JUnit, VCR, HAR, NDJSON, JSON, and Allure reports, and save failures with curl commands for replay. source
- Response validation
- It validates API responses against the OpenAPI specification. source
- Security and privacy
- The privacy policy says the company uses commercially acceptable means to protect personal data but cannot guarantee absolute security. source
- Specifications
- It supports OpenAPI 2.0, 3.0, 3.1, and 3.2, plus GraphQL schemas. source
- Stateful testing
- It chains API operations into multi-step workflows using links inferred from the schema. source
- Support
- The maker directs users to Discord for technical support, configuration questions, bug reports, and integration examples. source
- Test generation
- It generates cases that probe boundary values, type mismatches, and constraint violations. source
Checked against the maker's pages on 4 Oct 2026.