Schemathesis

Schemathesis automatically generates property-based tests from your OpenAPI or GraphQL schema and exercises the edge cases that break your API.

Finding a server error that manual testing missed

Find Bugs in Your API in 5 Minutes

Try it now

uvx schemathesis run https://example.schemathesis.io/openapi.json

This command will immediately find real bugs in a demo API and show you exactly how to reproduce them.

Why teams choose Schemathesis

• 🎯 Find real bugs on the first run (commonly 5–15 in production schemas).
• ⏱️ Point it at your schema—no per-endpoint tests to maintain.
• 🔄 Keeps pace with the spec; new endpoints are covered automatically.
• 🔌 Exports JUnit, HAR, and integrates with pytest or CI/CD.
• 📑 Uses your OpenAPI or GraphQL schema as the single source of truth.

Developer feedback

"The tool is amazing as it can test negative scenarios instead of me and much faster!"

— Luděk Nový, JetBrains

Documentation

• New to Schemathesis?

  ---

  Get started in minutes:

  • Quick Start - 5 minutes
  • CLI Tutorial - 20 minutes
  • Pytest Tutorial - 15 minutes

• How-To Guides

  ---

  Practical guides for common scenarios:

  • CI/CD Integration
  • Extending Schemathesis
  • More...

• Want to understand how it works?

  ---

  Deep dive into concepts:

  • Data Generation
  • Example Testing
  • Stateful Testing

• Need technical details?

  ---

  Complete reference:

  • Command-Line Interface
  • Python API
  • Configuration File

Important

Upgrading from older versions? See the Migration Guide for key changes.

Need help?

• Resources — Community articles, videos, and tutorials
• FAQ — Frequently Asked Questions