---
id: jmespath
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# jmespath — JSON Matching Expressions

License: permissive · Maintenance: active · Popularity: top 100 on PyPI

## Install

pip install jmespath
uv add jmespath
poetry add jmespath

## Description

JMESPath
========


.. image:: https://badges.gitter.im/Join Chat.svg
   :target: https://gitter.im/jmespath/chat


JMESPath (pronounced "james path") allows you to declaratively specify how to
extract elements from a JSON document.

For example, given this document::

    {"foo": {"bar": "baz"}}

The jmespath expression ``foo.bar`` will return "baz".

JMESPath also supports:

Referencing elements in a list.  Given the data::

    {"foo": {"bar": ["one", "two"]}}

The expression: ``foo.bar[0]`` will return "one".
You can also reference all the items in a list using the ``*``
syntax::

   {"foo": {"bar": [{"name": "one"}, {"name": "two"}]}}

The expression: ``foo.bar[*].name`` will return ["one", "two"].
Negative indexing is also supported (-1 refers to the last element
in the list).  Given the data above, the expression
``foo.bar[-1].name`` will return "two".

The ``*`` can also be used for hash types::

   {"foo": {"bar": {"name": "one"}, "baz": {"name": "two"}}}

The expression: ``foo.*.name`` will return ["one", "two"].


Installation
============

You can install JMESPath from pypi with:

.. code:: bash

    pip install jmespath


API
===

The ``jmespath.py`` library has...

## AI interpretation — verify before relying

JMESPath is a query language for extracting and transforming data from JSON documents using declarative path expressions, supporting nested object access, list indexing, wildcards, and custom functions.

Verdict: Stable, well-maintained JSON query tool in the top 100 PyPI packages with zero security vulnerabilities, no dependencies, and permissive MIT licensing—a low-risk choice for JSON extraction tasks.

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