openEHR

openEHR is the open specification family for electronic health records, and the main structural alternative to HL7 FHIR. It is governed by two UK not-for-profit entities: the openEHR Foundation, a company limited by guarantee that holds the intellectual property, and the openEHR Community Interest Company, trading as openEHR International, which has run day-to-day operations since 10 May 2019. Its defining idea is two-level modelling — a small, stable Reference Model that software implements once, plus a large, separately governed body of clinician-authored archetypes and templates expressed in the Archetype Definition Language and queried through the Archetype Query Language. The specification site publishes 68 specifications across 14 components at three maturity levels of openEHR's own declaring: Stable (AM, BASE, CDS, ITS-REST, ITS-XML, LANG, QUERY, RM, TERM), Development (CNF, ITS-BMM, ITS-JSON, SM) and Paused (PROC). The ITS-REST component ships real OpenAPI 3.0 for six API surfaces — EHR, Query, Definition and System are STABLE, Demographic and Admin are DEVELOPMENT — under a Creative Commons Attribution-NoDerivs 3.0 licence, with the tooling repositories under Apache-2.0. The coalition is unusually legible: 59 named people across the CIC Board, Foundation Board and the Specification, Clinical and Education program boards, with employers published beside 37 of them. What this repo holds are SPECIFICATIONS, not services — every contract here has the templated server https://{baseUrl}/v1 and describes what a conformant implementation must offer, so none of it is a callable API and it must never be read as one.

openEHR publishes 16 APIs on the APIs.io network, including ADL1.4 API, ADL2 API, AGENT API, and 13 more. Tagged areas include openEHR, Healthcare, EHR, Electronic Health Records, and Health Informatics.

openEHR’s developer surface includes product news, documentation, API reference, changelog, and 22 more developer resources.

🌐 Visit website 📡 Source on GitHub

28.0/100 thin ▬ flat Agent 17/100 agent aware Front door AI 2/6 trace Full breakdown ↓
scored 2026-09-24 · rubric v0.22.0

13 APIs

openEHR Healthcare EHR Electronic Health Records Health Informatics Standards Specification InteroperabilityInformation ModelArchetypes AQLADLClinical ModellingReference ModelNot-for-Profit

Kin Score

Kin Score How this is scored →
scored 2026-09-24 · rubric v0.22.0

Composite quality — 28.0/100 · thin

Contract Quality 11.2 / 19

Developer Ergonomics 3.9 / 15

Access Clarity 0.0 / 15

Operational Transparency 1.8 / 10

Contract Governance 1.4 / 9

Discoverability 5.0 / 8

Regulatory Posture 0.5 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 17/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Regulatory Posture applies to this provider. Its tags matched the Health regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/openehr: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 16

Individual APIs this provider publishes, each with its own machine-readable definition.

openEHR ADL1.4 API

Management of [AOM and ADL 1.4](https://specifications.openehr.org/releases/AM/latest) Operational Templates (OPTs). These templates can be created using [modelling tools](https...

openEHR ADL2 API

Management of [AOM2](https://specifications.openehr.org/releases/AM/latest/AOM2.html#_templates) templates. See also [ADL2 Template specifications](https://specifications.openeh...

openEHR AGENT API

Management of the [AGENT](https://specifications.openehr.org/releases/RM/latest/demographic.html#_agent_class) class.

openEHR COMPOSITION API

Management of [COMPOSITION](https://specifications.openehr.org/releases/RM/latest/ehr.html#_composition_class) and [VERSIONED_COMPOSITION](https://specifications.openehr.org/rel...

openEHR CONTRIBUTION API

Management of [CONTRIBUTION](https://specifications.openehr.org/releases/RM/latest/common.html#_contribution_class) class.

openEHR DIRECTORY API

Management of the [directory](https://specifications.openehr.org/releases/RM/latest/ehr.html#_directory) [FOLDER](https://specifications.openehr.org/releases/RM/latest/common.ht...

openEHR EHR API

Admin management of [EHRs](https://specifications.openehr.org/releases/RM/latest/ehr.html#_ehr_class).

openEHR EHR STATUS API

Management of [EHR_STATUS](https://specifications.openehr.org/releases/RM/latest/ehr.html#_ehr_status_class) and [VERSIONED_EHR_STATUS](https://specifications.openehr.org/releas...

openEHR GROUP API

Management of the [GROUP](https://specifications.openehr.org/releases/RM/latest/demographic.html#_group_class) class.

openEHR ITEM TAG API

Management of [ITEM_TAG](https://specifications.openehr.org/releases/RM/development/common.html#_item_tag_class) resources.

openEHR Options API

The Options API from openEHR — 1 operation(s) for options.

openEHR ORGANISATION API

Management of the [ORGANISATION](https://specifications.openehr.org/releases/RM/latest/demographic.html#_organisation_class) class.

openEHR PERSON API

Management of the [PERSON](https://specifications.openehr.org/releases/RM/latest/demographic.html#_person_class) class.

openEHR Query API

Management of stored (registered) queries in the system, including creation of new versions and retrieval by qualified name and version. These endpoints enable registration and ...

openEHR ROLE API

Management of the [ROLE](https://specifications.openehr.org/releases/RM/latest/demographic.html#_role_class) class.

openEHR VERSIONED PARTY API

Management of the [VERSIONED_PARTY](https://specifications.openehr.org/releases/RM/latest/demographic.html#_versioned_party_class) class.

Scroll for all 16

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Openehr Rm 1.0.3 All

0 properties

JSON SCHEMA

Openehr Rm 1.0.4 All

0 properties

JSON SCHEMA

Openehr Rm 1.1.0 All

0 properties

JSON SCHEMA

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Openehr Agentic Access

97 operations · 49 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Registry

Registry

DeveloperPortal

DeveloperPortal

Documentation 4

Reference material describing how the API behaves

Specification

Documentation

APIReference

JSONSchema

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LLMsTxt

LLMsTxt

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Vocabulary

Vocabulary

Conformance

Conformance

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

SourceCode

SourceCode

Operate 2

Status, limits, changes, and where to get help

ReleaseProcess

ReleaseProcess

ChangeLog

ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

License

License

Company 2

The organization behind the API

Website

Website

News

News

Other 9

Properties that don't map to a standard resource type

Governance

Participants

Membership

Charter

MailingList

Events

Participants

Adopters

WorkingGroups

Scroll for all 9

Source (apis.yml)

aid: openehr
name: openEHR
x-type: standards-body
x-category: Specification
x-host: null
type: Index
specificationVersion: '0.23'
created: '2026-09-02'
modified: '2026-09-02'
url: https://raw.githubusercontent.com/api-evangelist/openehr/refs/heads/main/apis.yml
description: 'openEHR is the open specification family for electronic health records, and the main structural alternative
  to HL7 FHIR. It is governed by two UK not-for-profit entities: the openEHR Foundation, a company limited by guarantee that
  holds the intellectual property, and the openEHR Community Interest Company, trading as openEHR International, which has
  run day-to-day operations since 10 May 2019. Its defining idea is two-level modelling — a small, stable Reference Model
  that software implements once, plus a large, separately governed body of clinician-authored archetypes and templates expressed
  in the Archetype Definition Language and queried through the Archetype Query Language. The specification site publishes
  68 specifications across 14 components at three maturity levels of openEHR''s own declaring: Stable (AM, BASE, CDS, ITS-REST,
  ITS-XML, LANG, QUERY, RM, TERM), Development (CNF, ITS-BMM, ITS-JSON, SM) and Paused (PROC). The ITS-REST component ships
  real OpenAPI 3.0 for six API surfaces — EHR, Query, Definition and System are STABLE, Demographic and Admin are DEVELOPMENT
  — under a Creative Commons Attribution-NoDerivs 3.0 licence, with the tooling repositories under Apache-2.0. The coalition
  is unusually legible: 59 named people across the CIC Board, Foundation Board and the Specification, Clinical and Education
  program boards, with employers published beside 37 of them. What this repo holds are SPECIFICATIONS, not services — every
  contract here has the templated server https://{baseUrl}/v1 and describes what a conformant implementation must offer, so
  none of it is a callable API and it must never be read as one.'
tags:
- openEHR
- Healthcare
- EHR
- Electronic Health Records
- Health Informatics
- Standards
- Specification
- Interoperability
- Information Model
- Archetypes
- AQL
- ADL
- Clinical Modelling
- Reference Model
- Not-for-Profit
tags_raw:
- openEHR
- Healthcare
- EHR
- Electronic Health Records
- Health Informatics
- Standards
- Specification
- Interoperability
- Information Model
- Archetypes
- AQL
- ADL
- Clinical Modelling
- Reference Model
- Not-for-profit
common:
- type: AgenticAccess
  url: agentic-access/openehr-agentic-access.yml
- type: Website
  url: https://openehr.org/
- type: Specification
  url: https://specifications.openehr.org/
- type: GitHubOrganization
  url: https://github.com/openEHR
- type: SourceCode
  url: https://github.com/openEHR/specifications-ITS-REST
- type: Governance
  url: https://openehr.org/governance/
- type: Participants
  url: https://openehr.org/specification-program/
- type: Membership
  url: https://openehr.org/professional-members-2/
- type: ReleaseProcess
  url: https://specifications.openehr.org/governance/release_strategy
- type: Charter
  url: https://specifications.openehr.org/governance/change_process
- type: Registry
  url: https://ckm.openehr.org/ckm/
- type: MailingList
  url: https://discourse.openehr.org/
- type: News
  url: https://openehr.org/news/
- type: Events
  url: https://openehr.org/events/
- type: License
  url: https://creativecommons.org/licenses/by-nd/3.0/
- type: DeveloperPortal
  url: https://developer.openehr.org/
- type: Documentation
  url: https://developer.openehr.org/implementation/
- type: APIReference
  url: https://specifications.openehr.org/releases/ITS-REST/latest/
- type: LLMsTxt
  url: https://specifications.openehr.org/llms.txt
- type: ChangeLog
  url: https://specifications.openehr.org/releases
- type: Vocabulary
  url: https://specifications.openehr.org/releases/TERM/latest/
- type: JSONSchema
  url: https://specifications.openehr.org/releases/ITS-JSON/latest/
- type: Conformance
  url: https://developer.openehr.org/conformance/
- type: Participants
  url: https://openehr.org/industry-partners/
- type: Adopters
  url: https://openehr.org/organisation-partners/
- type: WorkingGroups
  url: https://openehr.org/programs/specification/board_members
apis:
- aid: openehr:openehr-adl1-4-api
  name: openEHR ADL1.4 API
  description: "Management of [AOM and ADL 1.4](https://specifications.openehr.org/releases/AM/latest) Operational Templates\
    \ (OPTs). \nThese templates can be created using [modelling tools](https://www.openehr.org/downloads/modellingtools) such\
    \ as the Template Designer and the Archetype Designer. \n\nOperational templates simplify the creation of openEHR-based\
    \ input or storage implementations by, for a specific COMPOSITION template (use case), collecting all labels, requirements\
    \ and constraints from all contained archetypes and sub-templates into a single easily parsed file. \nThis file can be\
    \ a basis for UI-generation/creation and for data validation."
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - ADL1.4
  properties:
  - type: OpenAPI
    url: openapi/openehr-adl1-4-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-adl2-api
  name: openEHR ADL2 API
  description: 'Management of [AOM2](https://specifications.openehr.org/releases/AM/latest/AOM2.html#_templates) templates.


    See also [ADL2 Template specifications](https://specifications.openehr.org/releases/AM/latest/ADL2.html#_templates).'
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - ADL2
  properties:
  - type: OpenAPI
    url: openapi/openehr-adl2-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-agent-api
  name: openEHR AGENT API
  description: Management of the [AGENT](https://specifications.openehr.org/releases/RM/latest/demographic.html#_agent_class)
    class.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Agents
  tags_raw:
  - AGENT
  properties:
  - type: OpenAPI
    url: openapi/openehr-agent-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-composition-api
  name: openEHR COMPOSITION API
  description: 'Management of [COMPOSITION](https://specifications.openehr.org/releases/RM/latest/ehr.html#_composition_class)
    and [VERSIONED_COMPOSITION](https://specifications.openehr.org/releases/RM/latest/ehr.html#_versioned_composition_class)
    resources.


    Operations include create, retrieve, update, delete of compositions, and access to their version containers, specific
    versions and revision history.'
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - COMPOSITION
  properties:
  - type: OpenAPI
    url: openapi/openehr-composition-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-contribution-api
  name: openEHR CONTRIBUTION API
  description: Management of [CONTRIBUTION](https://specifications.openehr.org/releases/RM/latest/common.html#_contribution_class)
    class.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - CONTRIBUTION
  properties:
  - type: OpenAPI
    url: openapi/openehr-contribution-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-directory-api
  name: openEHR DIRECTORY API
  description: 'Management of the [directory](https://specifications.openehr.org/releases/RM/latest/ehr.html#_directory) [FOLDER](https://specifications.openehr.org/releases/RM/latest/common.html#_folder_class)
    resource.


    Operations include create, update, delete and time/version-based retrieval of the EHR’s directory structure.'
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Directory
  tags_raw:
  - DIRECTORY
  properties:
  - type: OpenAPI
    url: openapi/openehr-directory-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-ehr-api
  name: openEHR EHR API
  description: Admin management of [EHRs](https://specifications.openehr.org/releases/RM/latest/ehr.html#_ehr_class).
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - EHR
  properties:
  - type: OpenAPI
    url: openapi/openehr-ehr-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-ehr-status-api
  name: openEHR EHR STATUS API
  description: 'Management of [EHR_STATUS](https://specifications.openehr.org/releases/RM/latest/ehr.html#_ehr_status_class)
    and [VERSIONED_EHR_STATUS](https://specifications.openehr.org/releases/RM/latest/ehr.html#_versioned_ehr_status_class)
    resources.


    Operations include retrieval by time or version, update, and inspection of revision history for the versioned status of
    an EHR.'
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - EHR_STATUS
  properties:
  - type: OpenAPI
    url: openapi/openehr-ehr-status-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-group-api
  name: openEHR GROUP API
  description: Management of the [GROUP](https://specifications.openehr.org/releases/RM/latest/demographic.html#_group_class)
    class.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Group
  tags_raw:
  - GROUP
  properties:
  - type: OpenAPI
    url: openapi/openehr-group-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-item-tag-api
  name: openEHR ITEM TAG API
  description: Management of [ITEM_TAG](https://specifications.openehr.org/releases/RM/development/common.html#_item_tag_class)
    resources.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - ITEM_TAG
  properties:
  - type: OpenAPI
    url: openapi/openehr-item-tag-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-options-api
  name: openEHR Options API
  description: The Options API from openEHR — 1 operation(s) for options.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Options
  properties:
  - type: OpenAPI
    url: openapi/openehr-options-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-organisation-api
  name: openEHR ORGANISATION API
  description: Management of the [ORGANISATION](https://specifications.openehr.org/releases/RM/latest/demographic.html#_organisation_class)
    class.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Organisation
  tags_raw:
  - ORGANISATION
  properties:
  - type: OpenAPI
    url: openapi/openehr-organisation-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml
- aid: openehr:openehr-person-api
  name: openEHR PERSON API
  description: Management of the [PERSON](https://specifications.openehr.org/releases/RM/latest/demographic.html#_person_class)
    class.
  humanURL: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  tags:
  - Persons
  tags_raw:
  - PERSON
  properties:
  - type: OpenAPI
    url: openapi/openehr-person-api-openapi.yml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/ehr-validation.openapi.yaml
  - type: JSONSchema
    url: json-schema/openehr-rm-1.1.0-all.json
  - type: JSONSchema
    url: https://specifications.openehr.org/releases/ITS-JSON/latest/components/openehr_rm_1.1.0_all.json
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/query.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/query-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/definition.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/definition-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/overview.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/system-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/demographic.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/demographic-validation.openapi.yaml
  - type: Specification
    url: https://specifications.openehr.org/releases/ITS-REST/latest/admin.html
  - type: SourceCode
    url: https://github.com/openEHR/specifications-ITS-REST/blob/master/computable/OAS/admin-validation.openapi.yaml


# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openehr/refs/heads/main/apis.yml

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/openehr"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/openehr/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/openehr/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.