---
title: "Get versioned EHR_STATUS revision history"
method: GET
path: "/ehr/{ehr_id}/versioned_ehr_status/revision_history"
tags: ["EHR_STATUS"]
---

# Get versioned EHR_STATUS revision history

`GET /ehr/{ehr_id}/versioned_ehr_status/revision_history`

## Request

- Base URL: `https://openEHRSys.example.com/v1`
- URL: `https://openEHRSys.example.com/v1/ehr/{ehr_id}/versioned_ehr_status/revision_history`
- Auth: none required

Retrieves revision history of the VERSIONED_EHR_STATUS associated with the EHR identified by `ehr_id`.

## Path parameters

- `ehr_id` string, uuid, required

## Headers

- `Accept` 'application/json' | 'application/xml'
- `Content-Type` 'application/json' | 'application/xml'

## Response `200`

`200 OK` is returned when the requested REVISION_HISTORY is successfully retrieved.

- RevisionHistory: A REVISION_HISTORY resource
  - `items` RevisionHistoryItem[], required
    - `version_id` ObjectVersionId, required
      - `_type` string
      - `value` string, required
    - `audits` AuditDetails[], required
      - `_type` string
      - `system_id` string, required
      - `time_committed` DvDateTime, required
        - `_type` string
      - `change_type` DvCodedText, required
        - `_type` string
      - `description` DvText
        - `_type` string
      - `committer` PartyProxy, required
        - `_type` string, required
        - `external_ref` PartyRef
          - `namespace` string, required
          - `type` string, required
          - `id` ObjectId, required
            - `_type` string
            - `value` string, required

## Other responses

- `404`: `404 Not Found` is returned when an EHR with `ehr_id` does not exist.

## Changes

- **2026-04-27** `a81c0c47d29d`: 4 info
  - the `items/items/audits/items/description/mappings/items/match` response's property pattern was changed from `/^[><=?]$/` to `^[><=?]$` for the status `200`
  - the `items/items/audits/items/time_committed/allOf[subschema #1: DV_TEMPORAL]/accuracy/allOf[subschema #1: DV_AMOUNT]/allOf[subschema #1: DV_QUANTIFIED]/allOf[subschema #1: DV_ORDERED]/other_reference_ranges/items/meaning/mappings/items/match` response's property pattern was changed from `/^[><=?]$/` to `^[><=?]$` for the status `200`
  - the `items/items/audits/items/time_committed/allOf[subschema #1: DV_TEMPORAL]/allOf[subschema #1: DV_QUANTIFIED]/allOf[subschema #1: DV_ORDERED]/other_reference_ranges/items/meaning/mappings/items/match` response's property pattern was changed from `/^[><=?]$/` to `^[><=?]$` for the status `200`
  - added the required property `items/items/audits/items/time_committed/allOf[subschema #1: DV_TEMPORAL]/accuracy/value` to the response with the `200` status
- **2025-11-09** `660ec5865c0d`: 2 info
  - added the new optional `header` request parameter `Accept`
  - added the new optional `header` request parameter `Content-Type`
- **2025-03-13** `5e14066ac8dd`: 1 breaking
  - for the `path` request parameter `ehr_id`, the format changed from no format to `uuid`
- …earlier changes not shown

[Operation history](https://skmtc.dev/openehr/apis/ehr-api/changes/ehr/:ehr_id/versioned_ehr_status/revision_history/get.md)

---

[API](https://skmtc.dev/openehr/apis/ehr-api.md) - [All operations](https://skmtc.dev/openehr/apis/ehr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openehr/apis/ehr-api/revisions/c1a3a6532e9a?raw)
