---
id: types-jsonschema
version: "4.26.0.20260518"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-jsonschema — Typing stubs for jsonschema

License: permissive · Maintenance: active · Downloads: 11.5M/mo

## What it is and what it does

This is a type stub package that provides type annotations for the jsonschema library. It allows static type checkers to understand and validate code that uses jsonschema. The stubs are maintained as part of the typeshed project and are tested against mypy 2.1.0 and pyright 1.1.409.

When installed, the stubs enable your type checker to catch type errors in code that uses jsonschema for JSON validation. This is useful in larger codebases where type safety matters and you want to validate schema definitions and validation calls before runtime.

Use it for:

- Enable type checkers to validate code that uses jsonschema for JSON validation.
- Catch type errors in schema definitions and validation calls before runtime.
- Provide IDE autocomplete and type hints when working with jsonschema.
- Ensure type consistency in data validation pipelines that rely on jsonschema.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type hints for the jsonschema package, enabling static type checkers like mypy and pyright to validate code that uses jsonschema.

Yes, if you use jsonschema and run static type checking. It adds no runtime overhead and works with mypy 2.1.0 and pyright 1.1.409. Install it alongside jsonschema in projects where type safety is a priority. Not necessary if you don't use a type checker.

## Install

pip install types-jsonschema
uv add types-jsonschema
poetry add types-jsonschema

## Installing types-jsonschema

Before you install: Low friction install with a single runtime dependency (referencing). Actively maintained as part of typeshed, with recent updates and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in most projects without significant restrictions.

Quickstart:

pip install types-jsonschema

# In your code, import jsonschema normally;
# type checkers will use the stubs automatically
import jsonschema
schema = {"type": "object"}
jsonschema.validate({"key": "value"}, schema)

Requires Python 3.10 or later.

Verify before relying:

- Whether the stubs cover all jsonschema 4.26.0 APIs or only a subset.
- How frequently the stubs are updated relative to jsonschema releases.
- Whether type checker integration works transparently without additional configuration.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 11.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs for jsonschema, jsonschema type hints, mypy jsonschema types, static type checking jsonschema, pyright jsonschema annotations, jsonschema typing support, type-stubs, static-analysis

[View on SkillFed](https://skillfed.io/packages/types-jsonschema) · [View on PyPI](https://pypi.org/project/types-jsonschema/)