python-jsonschema/referencing

Cross-specification JSON referencing (JSON Schema, OpenAPI, and the one you just made up!)

stars

946

commits

Python

primary language

Sep 11, 2026

updated

referencing.readthedocs.io/

api

asyncapi

hypermedia

json

json-schema

jsonschema

openapi

Browse cluster: JSON Schema validation and tooling →

README

===============
``referencing``
===============

|PyPI| |Pythons| |CI| |ReadTheDocs| |pre-commit|

.. |PyPI| image:: https://img.shields.io/pypi/v/referencing.svg
  :alt: PyPI version
  :target: https://pypi.org/project/referencing/

.. |Pythons| image:: https://img.shields.io/pypi/pyversions/referencing.svg
  :alt: Supported Python versions
  :target: https://pypi.org/project/referencing/

.. |CI| image:: https://github.com/python-jsonschema/referencing/workflows/CI/badge.svg
  :alt: Build status
  :target: https://github.com/python-jsonschema/referencing/actions?query=workflow%3ACI

.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
   :alt: ReadTheDocs status
   :target: https://referencing.readthedocs.io/en/stable/

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/python-jsonschema/referencing/main.svg
  :alt: pre-commit.ci status
  :target: https://results.pre-commit.ci/latest/github/python-jsonschema/referencing/main


An implementation-agnostic implementation of JSON reference resolution.

See `the documentation <https://referencing.readthedocs.io/>`_ for more details.

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

Contributors

668 commits

137 commits

134 commits

3 commits

Similar repos

python-jsonschema/jsonschema

An implementation of the JSON Schema specification for Python

4,978

shared topics

sourcemeta/jsonschema

The CLI for working with JSON Schema. Covers formatting, linting, testing, bundling, and more for…

305

shared topics

Julian/jsonschema

An implementation of the JSON Schema specification for Python

4,978

shared topics

json-schema-org/json-schema-spec

The JSON Schema specification

5,149

shared topics

marksparkza/jschon

An object-oriented JSON Schema implementation for Python.

142

shared topics

json-schema/JSON-Schema-Test-Suite

A language agnostic test suite for the JSON Schema specifications

748

shared topics

json-schema-org/JSON-Schema-Test-Suite

A language agnostic test suite for the JSON Schema specifications

748

shared topics

APIDevTools/json-schema-ref-parser

Parse, Resolve, and Dereference JSON Schema $ref pointers in Node and browsers

1,115

shared topics

Languages

Python

100.0%

python-jsonschema/referencing

Cross-specification JSON referencing (JSON Schema, OpenAPI, and the one you just made up!)

stars

946

commits

Python

primary language

Sep 11, 2026

updated

referencing.readthedocs.io/

api

asyncapi

hypermedia

json

json-schema

jsonschema

openapi

Browse cluster: JSON Schema validation and tooling →

README

===============
``referencing``
===============

|PyPI| |Pythons| |CI| |ReadTheDocs| |pre-commit|

.. |PyPI| image:: https://img.shields.io/pypi/v/referencing.svg
  :alt: PyPI version
  :target: https://pypi.org/project/referencing/

.. |Pythons| image:: https://img.shields.io/pypi/pyversions/referencing.svg
  :alt: Supported Python versions
  :target: https://pypi.org/project/referencing/

.. |CI| image:: https://github.com/python-jsonschema/referencing/workflows/CI/badge.svg
  :alt: Build status
  :target: https://github.com/python-jsonschema/referencing/actions?query=workflow%3ACI

.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
   :alt: ReadTheDocs status
   :target: https://referencing.readthedocs.io/en/stable/

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/python-jsonschema/referencing/main.svg
  :alt: pre-commit.ci status
  :target: https://results.pre-commit.ci/latest/github/python-jsonschema/referencing/main


An implementation-agnostic implementation of JSON reference resolution.

See `the documentation <https://referencing.readthedocs.io/>`_ for more details.

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.