# openEHR Specifications

> openEHR is an open standard for electronic health records. This site publishes the normative specifications for the openEHR Reference Model, Archetype Model, query languages, implementation technology specifications, and related standards.

Every specification HTML page has a sibling Markdown representation for token-efficient LLM consumption. Append `.md` to any spec URL, or send `Accept: text/markdown` to the HTML URL.

Note: the Markdown representation contains the prose, rationale, and examples of each specification but **not** the per-class tables of attributes, functions, invariants and inherited members. Those tables are generated from the UML/BMM model and are only present in the HTML variant. To resolve an RM/AM class name to its authoritative location, use `/api/classes.json` or the HTML class index at `/classes`.

## Overview

- [Specification Components](https://specifications.openehr.org/components): Index of all specification components and their current status
- [Releases](https://specifications.openehr.org/releases): All published openEHR releases
- [Release Baseline](https://specifications.openehr.org/release_baseline): Current stable release baseline across all components
- [Development Baseline](https://specifications.openehr.org/development_baseline): In-progress development specifications
- [Class Index](https://specifications.openehr.org/classes): Index of all RM/AM classes defined across specifications
- [Change Process](https://specifications.openehr.org/governance/change_process): How openEHR specifications are governed and changed
- [Release Strategy](https://specifications.openehr.org/governance/release_strategy): Versioning and release strategy

## Structured APIs

- [Components catalog](https://specifications.openehr.org/api/components.json): JSON catalog of every component, release and specification
- [Class index](https://specifications.openehr.org/api/classes.json): Flat JSON list of every RM/AM class with its component, package and spec
- [Releases calendar](https://specifications.openehr.org/api/releases.json): JSON list of every published release with dates

## Specification Components

- [Archetype Model (AM)](https://specifications.openehr.org/releases/AM/Release-2.3.0): openEHR Archetype Model Component
  - [Archetype Technology](https://specifications.openehr.org/releases/AM/Release-2.3.0/Overview.html): Business case for archetyping; overview of archetype specifications
  - [ADL 2](https://specifications.openehr.org/releases/AM/Release-2.3.0/ADL2.html): Archetype Definition Language 2
  - [AOM 2](https://specifications.openehr.org/releases/AM/Release-2.3.0/AOM2.html): ADL 2 Object Model (enhanced AST)
  - [OPT 2](https://specifications.openehr.org/releases/AM/Release-2.3.0/OPT2.html): Operational Template 2
  - [Identification](https://specifications.openehr.org/releases/AM/Release-2.3.0/Identification.html): Archetype / template identifiers & versioning rules
  - [ADL 1.4](https://specifications.openehr.org/releases/AM/Release-2.3.0/ADL1.4.html): Archetype Definition Language 1.4
  - [AOM 1.4](https://specifications.openehr.org/releases/AM/Release-2.3.0/AOM1.4.html): ADL 1.4 Object Model (enhanced AST)
- [Base Model (BASE)](https://specifications.openehr.org/releases/BASE/Release-1.2.0): openEHR Base Model Component
  - [Architecture Overview](https://specifications.openehr.org/releases/BASE/Release-1.2.0/architecture_overview.html): Global description of openEHR design principles and architecture
  - [Foundation Types](https://specifications.openehr.org/releases/BASE/Release-1.2.0/foundation_types.html): Values, Structures, Interval, Date/times
  - [Base Types](https://specifications.openehr.org/releases/BASE/Release-1.2.0/base_types.html): Definitions, Identifiers
  - [Resource Model](https://specifications.openehr.org/releases/BASE/Release-1.2.0/resource.html): Authoring resources and translations
- [Clinical Decision Support (CDS)](https://specifications.openehr.org/releases/CDS/Release-2.0.1): openEHR Clinical Decision Support Specifications
  - [GDL](https://specifications.openehr.org/releases/CDS/Release-2.0.1/GDL.html): Guideline Definition Language v1
  - [GDL2](https://specifications.openehr.org/releases/CDS/Release-2.0.1/GDL2.html): Guideline Definition Language v2
- [Conformance Specifications (CNF)](https://specifications.openehr.org/releases/CNF/development): openEHR Conformance Specifications
  - [Conformance Guide](https://specifications.openehr.org/releases/CNF/development/guide.html): Guide to conformance testing in openEHR
  - [Platform Conformance Test Schedule](https://specifications.openehr.org/releases/CNF/development/platform_test_schedule.html): System Under Test (SUT), Test, Conformance Schedule, Profiles, Certification
  - [Platform Profiles](https://specifications.openehr.org/releases/CNF/development/profiles.html): Platform component profiles
  - [Conformance Certificate](https://specifications.openehr.org/releases/CNF/development/certificate.html): openEHR Conformance Certificate
- [BMM Schemas (ITS-BMM)](https://specifications.openehr.org/releases/ITS-BMM/development): openEHR BMM Schemas
- [JSON Schemas (ITS-JSON)](https://specifications.openehr.org/releases/ITS-JSON/development): openEHR JSON Schemas
- [REST API specifications (ITS-REST)](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3): openEHR REST API specifications Component (ITS-REST)
  - [Overview](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/overview.html): REST API Overview
  - [System](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/system.html): System API
  - [EHR API](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/ehr.html): EHR API
  - [Query API](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/query.html): Query API
  - [Definition API](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/definition.html): Definition API
  - [DEMOGRAPHIC API](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/demographic.html): DEMOGRAPHIC API
  - [Admin API](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/admin.html): Admin API
  - [Formats](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/simplified_formats.html): Simplified Formats
  - [SMART](https://specifications.openehr.org/releases/ITS-REST/Release-1.0.3/smart_app_launch.html): SMART on openEHR
- [XML Schemas (ITS-XML)](https://specifications.openehr.org/releases/ITS-XML/Release-2.0.0): openEHR XML Schemas (XSDs)
- [Generic Languages (LANG)](https://specifications.openehr.org/releases/LANG/Release-1.0.0): openEHR Languages Component
  - [ODIN](https://specifications.openehr.org/releases/LANG/Release-1.0.0/odin.html): Object Data Instance Notation
  - [BMM](https://specifications.openehr.org/releases/LANG/Release-1.0.0/bmm.html): Basic Meta-Model of models & expressions
  - [P_BMM](https://specifications.openehr.org/releases/LANG/Release-1.0.0/bmm_persistence.html): BMM human-readable serial format
  - [BEL](https://specifications.openehr.org/releases/LANG/Release-1.0.0/BEL.html): A basic expression language
  - [EL](https://specifications.openehr.org/releases/LANG/Release-1.0.0/EL.html): An advanced expression language based on BMM
- [Process Model (PROC)](https://specifications.openehr.org/releases/PROC/Release-1.7.0): openEHR Process Model Component
  - [Overview](https://specifications.openehr.org/releases/PROC/Release-1.7.0/overview.html): Overview of CDS, Guidelines, and Planning specifications
  - [Task Planning (TP)](https://specifications.openehr.org/releases/PROC/Release-1.7.0/task_planning.html): An adaptive, executable, team-based model of clinical workflow
  - [Decision Language](https://specifications.openehr.org/releases/PROC/Release-1.7.0/decision_language.html): Rule language for use with GDL, TP
  - [TP Visual Modelling Language (TP_VML)](https://specifications.openehr.org/releases/PROC/Release-1.7.0/tp_vml.html): A visual modelling language for clinical plans and workflows
  - [Process CDS, Guidelines and Planning Examples](https://specifications.openehr.org/releases/PROC/Release-1.7.0/process_examples.html): Real-world CDS/Process examples
- [Query Languages (QUERY)](https://specifications.openehr.org/releases/QUERY/Release-1.1.0): Query Languages Component
  - [AQL](https://specifications.openehr.org/releases/QUERY/Release-1.1.0/AQL.html): Archetype Query Language
  - [AQL Examples](https://specifications.openehr.org/releases/QUERY/Release-1.1.0/AQL_examples.html): AQL Examples
- [Reference Model (RM)](https://specifications.openehr.org/releases/RM/Release-1.1.0): openEHR Reference Model Component
  - [EHR](https://specifications.openehr.org/releases/RM/Release-1.1.0/ehr.html): Top-level health record info model
  - [Demographic](https://specifications.openehr.org/releases/RM/Release-1.1.0/demographic.html): Top-level demographics info model
  - [Common](https://specifications.openehr.org/releases/RM/Release-1.1.0/common.html): Common semantic patterns and structures
  - [Data Structures](https://specifications.openehr.org/releases/RM/Release-1.1.0/data_structures.html): Common data structures
  - [Data Types](https://specifications.openehr.org/releases/RM/Release-1.1.0/data_types.html): Information model of data types, including quantities, date/times, plain and coded text, time specification, multimedia and URIs
  - [Support](https://specifications.openehr.org/releases/RM/Release-1.1.0/support.html): (mostly obsolete) Terminology and Measurement service interfaces
  - [Integration](https://specifications.openehr.org/releases/RM/Release-1.1.0/integration.html): Model of free-form external system data
  - [EHR Extract](https://specifications.openehr.org/releases/RM/Release-1.1.0/ehr_extract.html): Top-level EHR Extract request and response model
- [Service Model (SM)](https://specifications.openehr.org/releases/SM/development): openEHR Service Model Component
  - [Platform Services](https://specifications.openehr.org/releases/SM/development/openehr_platform.html): Ehr, Query, Definitions, EhrIndex, Admin, Demographic, Terminology, Message, SystemLog
  - [SIM B](https://specifications.openehr.org/releases/SM/development/simplified_im_b.html): Simplified Information Model 'B' for use with Simplified Data Template
  - [SDF](https://specifications.openehr.org/releases/SM/development/serial_data_formats.html): Serial data formats for use in REST and other contexts
- [openEHR Terminology (TERM)](https://specifications.openehr.org/releases/TERM/Release-3.0.0): openEHR Terminology Component
  - [Support Terminology](https://specifications.openehr.org/releases/TERM/Release-3.0.0/SupportTerminology.html): Support Terminology and code-sets needed for RM, AM and SM

## Optional

- [Sitemap](https://specifications.openehr.org/sitemap.xml): Full URL list of all published specification pages