---
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.

---

[API](https://skmtc.net/openehr/apis/ehr-api.md) · [All operations](https://skmtc.net/openehr/apis/ehr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openehr/ehr-api/revisions/a0e37a217524/schema)