---
id: types-python-jose
version: "3.5.0.20260408"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-python-jose — Typing stubs for python-jose

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

## What it is and what it does

This is a type-stub package that provides static type information for python-jose, a library used for JWT handling and cryptographic operations. It is part of the typeshed project and allows type checkers like mypy and pyright to understand and validate code that imports and uses python-jose. The stubs are tested against mypy 1.20.0 and pyright 1.1.408 and target python-jose version 3.5.*.

Type stubs are not runtime code—they exist only to help your development tools catch type errors before execution. Installing this package alongside python-jose lets your IDE and CI pipelines perform static analysis on JWT operations and cryptographic calls. The package has low install friction, depending only on types-pyasn1, and is actively maintained through the typeshed repository.

Use it for:

- Enable mypy or pyright to type-check code that calls python-jose JWT functions without runtime overhead.
- Catch type mismatches in token encoding/decoding workflows during development rather than at runtime.
- Provide IDE autocomplete and inline type hints when working with python-jose in an editor that supports type stubs.
- Validate cryptographic key handling and algorithm parameters passed to python-jose functions.

## Worth the install?

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

Provides type hints for the python-jose library, enabling static type checkers like mypy and pyright to validate code that uses python-jose for JWT and cryptographic operations.

Yes, if you use python-jose and want static type checking. Install it alongside python-jose in development and CI environments. It has no runtime cost, low friction, and is actively maintained. Not needed if you don't use a type checker or don't use python-jose.

## Install

pip install types-python-jose
uv add types-python-jose
poetry add types-python-jose

## Installing types-python-jose

Before you install: Low install friction with a single type-stub dependency (types-pyasn1). Actively maintained as part of typeshed; last commit 2026-08-14 with no archived status.

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

Quickstart:

pip install types-python-jose

# In your code using python-jose:
from jose import jwt
token: str = jwt.get_unverified_header(encoded_token)

Requires Python 3.10 or later; python-jose itself must be installed separately for runtime use.

Verify before relying:

- Whether this stub package is kept in sync with all python-jose 3.5.x releases or only a subset.
- Coverage completeness of type annotations across the full python-jose API surface.

## Package facts

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

## Tags

type stubs python-jose, mypy stubs jwt, python-jose type hints, static type checking jose, pyright python-jose, typing stubs cryptography, type-stubs, static-analysis

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