observation.json

{
   "resource": "Observation",
   "toolName": "observation",
   "title": "Observation",
   "description": "Search for or read a FHIR Observation resource covering labs, vitals, device measurements, and other structured clinical values. For direct read, provide _id alone. For search, patient is always required plus at least one of category or code. If the user gives a plain-language measurement or device concept and the correct code is uncertain, resolve it with code_search before using category or code filters. Category-only searches are broad fallbacks after code resolution. Common categories: laboratory, vital-signs, core-characteristics. For high-frequency or multi-day data, use compact mode with a high maxResults. Use category=core-characteristics with code 76516-4 (gestational age) or 8339-4 (birth weight) for core characteristic lookups.",
   "supportsDirectRead": true,
   "searchParams": {
      "_id": "Observation resource ID — performs direct read when provided alone",
      "based-on": "Reference to the request (order) that triggered the observation",
      "category": "Observation category (e.g. laboratory, vital-signs, core-characteristics)",
      "code": "LOINC or other observation code",
      "combo-code": "Code for the observation or any of its components (LOINC, SNOMED)",
      "combo-data-absent-reason": "Why the value is missing on the observation or any of its components",
      "combo-value-concept": "Coded value of the observation or any of its components",
      "component-code": "Code of an observation component",
      "component-data-absent-reason": "Why the value is missing on an observation component",
      "component-value-concept": "Coded value of an observation component",
      "data-absent-reason": "Why the observation value is missing",
      "date": "Date or date range (e.g. ge2024-01-01)",
      "derived-from": "Related resource this observation is derived from",
      "device": "Device that generated the observation",
      "encounter": "Encounter during which the observation was made",
      "focus": "What the observation is about, when not the patient",
      "has-member": "Related component or member observation (e.g. panel members)",
      "identifier": "Business identifier",
      "issued": "Date/time the observation was made available",
      "method": "Method used to produce the observation",
      "part-of": "Larger event this observation is part of",
      "patient": "Patient resource ID or reference — required for search",
      "performer": "Who performed the observation",
      "specimen": "Specimen used for the observation",
      "status": "Observation status (e.g. final, preliminary)",
      "subject": "Subject of the observation (Patient) — equivalent to patient, not usable at the same time",
      "value-concept": "Coded value of the observation (when the result is a code)",
      "value-date": "Date/time value of the observation (when the result is a date)",
      "value-string": "String value of the observation (when the result is text)"
   },
   "requireOneOf": [
      [
         "patient",
         "category"
      ],
      [
         "patient",
         "code"
      ],
      [
         "subject",
         "category"
      ],
      [
         "subject",
         "code"
      ]
   ]
}