---
title: "Get an observation"
method: GET
path: "/api/2026-01-01/medical-record/observations/{observation_id}"
tags: ["Observations"]
---

# Get an observation

`GET /api/2026-01-01/medical-record/observations/{observation_id}`

## Request

- Base URL: `https://jdpdocsdemo.jane.qa`
- URL: `https://jdpdocsdemo.jane.qa/api/2026-01-01/medical-record/observations/{observation_id}`
- Auth: OAuth 2
  - Authorization code: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/auth?response_type=code&resource=https://jdpdocsdemo.jane.qa&prompt=consent`
  - Token URL: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/token` scopes: `observations:read`

Get an observation by its ID

## Path parameters

- `observation_id` string, required

## Response `200`

The observation

- Observation
  - `id` string, uuid: UUIDv7 identifier for the observation
  - `patient_id` string, uuid, required: Reference to the patient
  - `practitioner_id` string, uuid: Reference to the practitioner who performed/recorded the observation
  - `encounter_id` string, uuid: Reference to the encounter where the observation was made
  - `category` 'vital_signs' | 'laboratory' | 'exam', required: The classification of the type of observation
  - `created_at` string, date-time: When the observation record was created
  - `updated_at` string, date-time: When the observation record was updated
  - `issued_at` string, date-time: When the observation was issued/reported
  - `note` string: Additional notes about the observation
  - `values` ObservationValue[]: Array of observation components
    - `id` string, uuid: UUIDv7 identifier for the component
    - `code` string, required: The specific code for this component (e.g., LOINC or SNOMED CT code)
    - `system` string, required: The coding system used (e.g., 'http://loinc.org')
    - `display` string: Human-readable display name for the code
    - `value` string, required: The actual value of the component
    - `value_type` 'string' | 'boolean' | 'numeric', required: The data type of the value
    - `unit` string: The unit for the value (if applicable)
  - `document_ids` string[]: Array of document upload IDs to attach to the observation. All documents must exist and be verified.
  - `documents` object[]: Array of document upload IDs currently attached to the observation.
    - `id` string, uuid, required

## Other responses

- `404`: The observation was not found

## Changes

- **2026-11-03** `01798f613a5e`: 2 info
  - added the optional property `documents` to the response with the `200` status
  - the response optional property `document_ids` became write-only for the status `200`

[Operation history](https://skmtc.dev/jane/apis/jdp-api/changes/api/2026-01-01/medical-record/observations/:observation_id/get.md)

---

[API](https://skmtc.dev/jane/apis/jdp-api.md) - [All operations](https://skmtc.dev/jane/apis/jdp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jane/apis/jdp-api/revisions/01798f613a5e?raw)