Skip to main content
Send a GET request with the observation ID to retrieve a single observation record. The full observation is returned, including its value type (quantity, string, or codeable concept) and any components for multi-part measurements.

​
Request

​
id
string
required
The observation ID to retrieve, e.g. obs_abc001.

​
Example

curl https://api.clinikapi.com/v1/observations/obs_abc001 \
  -H "x-api-key: clk_live_your_key"

​
Response

​
id
string
Unique identifier for the observation.
​
status
string
Observation status: registered, preliminary, final, amended, corrected, or cancelled.
​
code
string | object
The coded concept identifying the observation — a string or an object with system, code, and display.
​
patientId
string
ID of the patient this observation belongs to.
​
encounterId
string
ID of the related encounter, if recorded.
​
performerId
string
ID of the practitioner who performed the observation, if recorded.
​
category
string
Observation category: vital-signs, laboratory, social-history, or exam.
​
effectiveDateTime
string
ISO 8601 datetime when the measurement was clinically effective.
​
valueQuantity
object
Numeric measurement with value, unit, system, and code. Present when a quantity value was recorded.
​
valueString
string
Free-text value. Present when a string value was recorded.
​
valueCodeableConcept
object
Coded value with system, code, and display. Present when a coded value was recorded.
​
component
array
Sub-observations for multi-component measurements. Each item contains code and a value field.
​
interpretation
string
Clinical interpretation: N, H, L, A, HH, or LL.
​
referenceRange
object
Normal range with low, high, and text fields.
​
bodySite
string
Anatomical site where the observation was made.
​
method
string
Measurement method used.
​
note
string
Clinical notes about the observation.
​
createdAt
string
ISO 8601 datetime when the record was created.
​
updatedAt
string
ISO 8601 datetime of the last update.
Example response
{
  "data": {
    "id": "obs_abc001",
    "status": "final",
    "code": {
      "system": "http://loinc.org",
      "code": "2339-0",
      "display": "Glucose [Mass/volume] in Blood"
    },
    "patientId": "pt_abc123",
    "category": "laboratory",
    "effectiveDateTime": "2025-01-15T10:00:00Z",
    "valueQuantity": {
      "value": 95,
      "unit": "mg/dL"
    },
    "interpretation": "N",
    "referenceRange": {
      "low": { "value": 70, "unit": "mg/dL" },
      "high": { "value": 100, "unit": "mg/dL" },
      "text": "70-100 mg/dL"
    },
    "createdAt": "2025-01-15T10:00:10Z",
    "updatedAt": "2025-01-15T10:00:10Z"
  },
  "meta": {
    "requestId": "req_t5l8f2c7",
    "timestamp": "2025-01-15T11:00:00Z",
    "status": 200,
    "rateLimitTotal": 1000,
    "rateLimitRemaining": 990,
    "rateLimitReset": 30
  }
}