---
id: types-jmespath
version: "1.1.0.20260724"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-jmespath — Typing stubs for jmespath

License: permissive · Maintenance: active · Downloads: 892.9K/mo

## What it is and what it does

types-jmespath is a type stub package from the typeshed project that provides type annotations for the jmespath library. It allows static type checkers like mypy and pyright to understand and validate code that uses jmespath for querying JSON data structures. The stubs are maintained as part of typeshed and track jmespath version 1.1.*.

This package has no runtime dependencies and is purely a development tool—it does not affect how jmespath itself runs. You install it alongside jmespath so that your type checker can verify that you're using jmespath's API correctly. The package is actively maintained, with recent commits and releases, and has been tested against mypy 2.3.0 and pyright 1.1.411.

Use it for:

- Enable mypy or pyright to catch type errors in code that calls jmespath.search() or other jmespath functions
- Provide IDE autocomplete and inline type hints when working with jmespath in a modern editor
- Enforce consistent type safety in projects that query JSON using jmespath expressions
- Validate that jmespath query results are handled with the correct expected types

## Worth the install?

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

Provides type annotations for the jmespath package, enabling static type checkers like mypy and pyright to validate code that uses jmespath for JSON querying.

Yes, if you use jmespath and want static type checking. Install it as a development dependency alongside jmespath to enable type checkers to validate your code. No security concerns, low friction, and actively maintained. If you don't use a type checker or don't use jmespath, it has no value.

## Install

pip install types-jmespath
uv add types-jmespath
poetry add types-jmespath

## Installing types-jmespath

Before you install: Low friction installation with no runtime dependencies. Actively maintained as part of typeshed; last commit 2026-08-14 and released 21 days ago. Requires Python 3.10 or later.

License in practice: Licensed under Apache-2.0 (permissive), imposing no significant restrictions on use or distribution.

Quickstart:

pip install types-jmespath

# In your code, type checkers will now understand jmespath imports:
import jmespath
result: str = jmespath.search('foo.bar', {'foo': {'bar': 'baz'}})

Requires Python 3.10 or later; type checking requires a compatible type checker (mypy 2.3.0 or pyright 1.1.411 tested).

Verify before relying:

- Whether this stub package is automatically discovered by type checkers or requires explicit configuration in pyproject.toml or similar
- Coverage completeness relative to jmespath 1.1.* API surface

## Package facts

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

## Tags

type stubs jmespath, jmespath type hints, static type checking jmespath, mypy jmespath annotations, pyright jmespath types, jmespath typing support, type checker stubs, type-stubs, typeshed

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