Open industry specifications, models
and software for e-health


openEHR Specifications

for an interoperable healthcare information platform

'openEHR' is the name of a technology, consisting of open specifications, clinical models and software that can be used to create standards, and build information and interoperability solutions for healthcare. It is completely model-driven, and separates domain semantics out from software, into models created by domain professionals.

The openEHR specifications consist of information models for healthcare data, including the EHR (how to record clinical observations?) and Demographics (parties, roles and relationships), a portable Query Language (AQL), the Archetype formalism (adopted by ISO 13606-2:2019) for expressing domain content, the CDS Guidelines and Care Pathways, and an open API specification.

openEHR Primer

What should I read first?

If you are a developer and want to get to work right away, we recommend the following:

If you are an architect or just want to understand the platform architecture properly, we recommend reading/skimming the following guides:

The specifications are managed by the Specifications Editorial Committee (SEC), with extensive input from the community. If you are interested in details of the governance process, see the governance and change management pages.

If you are mainly interested in open source implementations and code bases, see the implementation page or go straight to openEHR@Github.

How are the Specifications organised?

The specifications come in 3 categories:

  • abstract specifications: platform-independent UML information models, service interfaces, Antlr grammars etc;
  • implementation technology specifications (ITS): platform-specific specs, including XSDs, JSON-schema, REST APIs
  • conformance specification: defining the basis of conformance testing and product profiling.

Within these categories are separate components, each containing specifications on a specific topic. For convenience, some of the components are in groups, as visualise with this diagram.

Release baseline Development baseline Implementation Technologies

Where can I discuss Specifications and Implementation?

We have extensive discussion groups at the openEHR Discourse site, particularly the following categories:

See also the openEHR Wiki - specifications space and openEHR Jira specification projects.


Latest releases: ITS v2.0.0 (May 2021) ITS-XML v2.0.0 (Apr 2021) ITS-REST v1.0.2 (Apr 2021) BASE v1.2.0 (Apr 2021) RM v1.1.0 (Sep 2020) QUERY v1.0.1 (Jul 2020) more...