JSON Schema (jsonschema) Internet Drafts

      
 JSON Schema
 
 draft-ietf-jsonschema-json-schema-00.txt
 Date: 12/05/2026
 Authors: Lisa Dusseault, Austin Wright, Henry Andrews
 Working Group: JSON Schema (jsonschema)
 JSON Schema defines the media type "application/schema+json", a JSON- based format for describing the structure of JSON data. JSON Schema asserts what a JSON document must look like, ways to extract information from it, and how to interact with it. The "application/ schema-instance+json" media type provides additional feature-rich integration with "application/schema+json" beyond what can be offered for "application/json" documents.

data-group-menu-data-url="/group/groupmenu.json">

JSON Schema (jsonschema)

WG Name JSON Schema
Acronym jsonschema
Area Applications and Real-Time Area (art)
State Active
Charter charter-ietf-jsonschema-01 Approved
Document dependencies
Personnel Chair Paul E. Hoffman
Area Director Andy Newton
Mailing list Address json@ietf.org
To subscribe https://www.ietf.org/mailman/listinfo/json
Archive https://mailarchive.ietf.org/arch/browse/json/
Chat Room address https://zulip.ietf.org/#narrow/stream/jsonschema

Charter for Working Group

JSON Schema Working Group Charter

JSON Schema is a JSON language for describing the data structures of other JSON documents.
JSON Schema is widely referenced within the IETF and by other organizations such as 3GPP, W3C, HR Open Standards,
OpenBanking UK, OpenAPI Initiative, ETSI, C2PA, and more. JSON Schema is widely used in many open source projects
and commercial offerings.

However, JSON Schema is described in at least 5 IETF Internet-Drafts but has never been published as an RFC. The goal of
the JSONSCHEMA working group is to produce a stable, reference specification of JSON Schema as a
Proposed Standard. This specification will contain only features and
mechanisms in JSON Schema that are in known use, and the working group may remove features
and mechanisms it is (a) confident are not in use and (b) are likely not to be used in
the future. Also, the working group will ensure that changes are carefully assessed to avoid breaking known deployments.
To achieve this goal, the document produced by the JSONSCHEMA working group will have the following scope:

  • Document, mitigate, or fix any security concerns with JSON Schema.
  • Register values into existing IANA registries, such as a media-type for JSON Schema documents.
  • Create new IANA registries specific to JSON Schema.
  • Document or mitigate operational and interoperability concerns with JSON Schema.

draft-dusseault-json-schema is a recent attempt to collect all known uses of JSON Schema
into a specification. The working group may use this document as a starting point for the
development of a Proposed Standard.

The JSONSCHEMA working group will not produce any other language for describing JSON data structures.
The working group may recharter to broaden the group's scope of work only after completing the
working group's initial milestone.

The JSONSCHEMA working group will liaise with other organizations, including but not limited to,
ETSI, 3GPP, and OpenAPI Initiative regarding known uses of JSON Schema mechanisms.

Milestones

Date Milestone Associated documents
May 2027 Request publication of JSON Schema as a Proposed Standard.