---
title: "Get EHR by id"
method: GET
path: "/ehr/{ehr_id}"
tags: ["EHR"]
---

# Get EHR by id

`GET /ehr/{ehr_id}`

Retrieve the EHR with the specified `ehr_id`.

## Path parameters

- `ehr_id` string, uuid, required

## Headers

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

## Response `200`

`200 OK` is returned when the requested EHR resource is successfully retrieved.

- Ehr — An EHR resource
  - `system_id` HierObjectId
    - `_type` string
    - `value` string, required
  - `ehr_id` HierObjectId
    - `_type` string
    - `value` string, required
  - `ehr_status` ObjectRefOfObjectVersionId
    - `namespace` string, required
    - `type` string, required
    - `id` ObjectId, required
      - `_type` string
      - `value` string, required
  - `ehr_access` ObjectRefOfObjectVersionId
    - `namespace` string, required
    - `type` string, required
    - `id` ObjectId, required
      - `_type` string
      - `value` string, required
  - `time_created` DvDateTime
    - `_type` string

## Other responses

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

## Changes

- **2026-04-27** `a81c0c47d29d` — 3 info
  - the `time_created/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 `time_created/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 `time_created/allOf[subschema #1: DV_TEMPORAL]/accuracy/value` to the response with the `200` status
- **2025-11-05** `660ec5865c0d` — 1 info
  - added the new optional `header` request parameter `Accept`
- **2025-03-13** `5e14066ac8dd` — 1 breaking
  - for the `path` request parameter `ehr_id`, the type/format was changed from `string`/`` to `string`/`uuid`
- **2024-09-11** `932a3707247c` — 2 info
  - added `PARTY_REF` discriminator mapping keys to the `ehr_access/allOf[subschema #1: OBJECT_REF]/` response property for the response status `200`
  - added `PARTY_REF` discriminator mapping keys to the `ehr_status/allOf[subschema #1: OBJECT_REF]/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/openehr/apis/ehr-api/changes/ehr/:ehr_id/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)