OPTIMADE schemas
The OPTIMADE schemas website https://schemas.optimade.org and its corresponding repository hosts permanent URLs to OPTIMADE schemas.
Find out more about OPTIMADE at our homepage.
Minor versions of the schema can be acquired by modifying the version tag in the URL. Version tags will always point to the latest release compatible with that version.
Full respone format schemas in json-schema format:
OpenAPI schemas of older versions:
OPTIMADE Property Schemas (property definitions)
OPTIMADE publishes OPTIMADE Property Definitions for the standard properties part of the OPTIMADE API.
All definitions have stable URI IDs ($id in JSON) that represent the entity being defined.
The URIs are resolvable URLs that resolve to a human-readable description.
If .json is appended to the URL it resolves to a machine readable JSON version of the definition is provided with a format documented in the OPTIMADE specification.
The content at these URLs may change with amendedments or clarifications, but a URI ID will always refer to what is functionally the same definition.
If an entity needs to be redefined it is given a new URI and the old URI is retained to represent the prior definition.
A good place to start to browse these definitions is the definition of the OPTIMADE standard v1.3:
For the Physical Unit definitions, a good place to start is a collection of units suitable for use with OPTIMADE:
A complete index of all provided definition files is available at:
We also provide, generated from the definitons:
-
JSON Schemas for validation of OPTIMADE JSON:API responses:
-
JSON-LD contexts to be used with OPTIMADE responses (as a topmost
@contextfield): -
OpenAPI schemas for v1.3 and v1.2 are not yet available.
The exact state of the definition files at the time of a patch release of OPTIMADE are placed at URLs with the format https://schemas.optimade.org/releases/vMAJOR.MINOR.PATCH/vMAJOR.MINOR/... and indexed at https://schemas.optimade.org/releases/vMAJOR.MINOR.PATCH/vMAJOR.MINOR/index.html.
The double URL segments for versions may look redundant, however, they take this form to keep a complete historical record that preserves amendments and clarifications that may have altered older definition files even after the entity has been redefined.
For the v1.3.0 patch release the complete index is available here: