---
title: "Get versioned EHR_STATUS version at time"
method: GET
path: "/ehr/{ehr_id}/versioned_ehr_status/version"
tags: ["EHR_STATUS"]
---

# Get versioned EHR_STATUS version at time

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

Retrieves a VERSION from the VERSIONED_EHR_STATUS associated with the EHR identified by `ehr_id`.

If `version_at_time` is supplied, retrieves the VERSION extant _at specified time_, otherwise retrieves the _latest_ VERSION.

## Path parameters

- `ehr_id` string, uuid, required

## Query parameters

- `version_at_time` string, datetime

## Headers

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

## Response `200`

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

- VersionOfEhrStatus — A VERSION resource
  - `_type` string
  - `contribution` ObjectRefOfHierObjectId, required
    - `namespace` string, required
    - `type` string, required
    - `id` ObjectId, required
      - `_type` string
      - `value` string, required
  - `signature` string
  - `commit_audit` AuditDetails, required — The set of attributes required to document the committal of an information item to a repository.
    - `_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
  - `data` EhrStatus, required
    - `_type` string

## Other responses

- `400` — `400 Bad Request` is returned when the request could not be parsed or is invalid (e.g. malformed request URL syntax, missing required header or parameter, or syntactically invalid header, parameter or content). The response body MAY contain error details.
- `404` — `404 Not Found` is returned when an EHR with `ehr_id` does not exist, or when a version of the resource identified by the request parameters (at specified `version_at_time`) does not exist.

## Changes

- **2026-04-27** `a81c0c47d29d` — 15 info
  - added `SECTION` discriminator mapping keys to the `data/allOf[subschema #1: Versionable]/allOf[subschema #1: LOCATABLE]/` response property for the response status `200`
  - added `SECTION` discriminator mapping keys to the `data/allOf[subschema #1: Versionable]/allOf[subschema #1: LOCATABLE]/allOf[subschema #1: PATHABLE]/` response property for the response status `200`
  - the `commit_audit/description/mappings/items/match` response's property pattern was changed from `/^[><=?]$/` to `^[><=?]$` for the status `200`
  - the `commit_audit/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`
  - …11 more
- **2025-11-05** `660ec5865c0d` — 2 info
  - added the new optional `header` request parameter `Accept`
  - added the new optional `header` request parameter `Content-Type`
- **2025-03-13** `5e14066ac8dd` — 2 breaking
  - for the `path` request parameter `ehr_id`, the format changed from no format to `uuid`
  - for the `query` request parameter `version_at_time`, the format changed from no format to `datetime`
- …earlier changes not shown

[Full history](https://skmtc.dev/openehr/apis/ehr-api/changes/ehr/:ehr_id/versioned_ehr_status/version/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-service-production.skmtc.workers.dev/v1/apis/openehr/ehr-api/revisions/a0e37a217524/schema)