AvaEcosystem Docs
Log in Request access

Observation

Measurements and findings — vitals, laboratory results, and similar.

Observation is Backend Services only in the current registry: there are no patient/Observation.* or user/Observation.* launch scopes, so interactive SMART apps cannot request Observation access. Do not request or advertise launch scopes for it. Backend Services registration is not yet available through this portal.

Advertises a validated CA Core+ profile.

Access

Mode Interactions Scopes
App launch — —
Backend services read + search system/Observation.rs

No launch scopes exist for Observation — requesting them fails with invalid_scope.

Search parameters

Search results are searchset Bundles; follow the Bundle's next link for cursor pagination.

Parameter Type Description
_id token Match a specific logical resource id.
_lastUpdated date Filter by last modification time; supports FHIR date prefixes such as ge and lt.
_count number Page size hint for the searchset Bundle.
_page_token string Opaque pagination cursor. Never construct one — follow the Bundle's next link.
patient reference Observations for a specific Patient.
category token Observation category, such as vital-signs or laboratory.
code token The kind of observation, by code.
date date Clinically effective time; supports FHIR date prefixes.

Search vitals for a patient (Backend Services)

GET /Observation?patient={id}&category=vital-signs 200 OK
Request 
curl "https://sandbox.avaemr.ca/fhir/r4/{partition_id}/Observation?patient=Patient/synthetic-patient-1&category=vital-signs" \
  -H "Authorization: Bearer $BACKEND_ACCESS_TOKEN" \
  -H "Accept: application/fhir+json"
Response · backend context 
{
  "resourceType": "Bundle",
  "type": "searchset",
  "link": [
    { "relation": "self", "url": "https://sandbox.avaemr.ca/fhir/r4/{partition_id}/Observation?patient=Patient/synthetic-patient-1&category=vital-signs" }
  ],
  "entry": [
    {
      "resource": {
        "resourceType": "Observation",
        "id": "synthetic-observation-1",
        "status": "final",
        "category": [{ "coding": [{ "system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "vital-signs" }] }],
        "code": { "coding": [{ "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" }] },
        "subject": { "reference": "Patient/synthetic-patient-1" },
        "effectiveDateTime": "2026-07-15T09:05:00-04:00",
        "valueQuantity": { "value": 72, "unit": "beats/minute", "system": "http://unitsofmeasure.org", "code": "/min" }
      },
      "search": { "mode": "match" }
    }
  ]
}