Orion Health FHIR API

Fast Healthcare Interoperability Resources (FHIR) API for accessing and exchanging healthcare data.

Documentation

Specifications

Schemas & Data

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/json-ld/orion-healthcare-context.jsonld
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-allergyintolerance.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-careplan.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-condition.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-diagnosticreport.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-documentreference.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-encounter.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-immunization.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-medicationrequest.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-metadata.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-observation.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-patient.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/capabilities/fhir-procedure.yaml

OpenAPI Specification

orion-fhir-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Orion Health FHIR API
  description: >-
    The Orion Health FHIR API provides standards-based access to healthcare data
    using the HL7 FHIR (Fast Healthcare Interoperability Resources) specification.
    It enables healthcare organizations to read, search, create, and update clinical
    resources including patients, encounters, observations, conditions, medications,
    allergies, procedures, diagnostic reports, and care plans. The API conforms to
    FHIR R4 (v4.0.1) and supports both JSON and XML representations.
  version: 1.0.0
  contact:
    name: Orion Health API Support
    email: [email protected]
    url: https://www.orionhealth.com/support
  license:
    name: Proprietary
    url: https://www.orionhealth.com/terms-of-service
  termsOfService: https://www.orionhealth.com/terms-of-service
servers:
  - url: https://api.orionhealth.com/fhir
    description: Production FHIR Server
  - url: https://sandbox.orionhealth.com/fhir
    description: Sandbox FHIR Server
security:
  - oauth2: []
  - bearerAuth: []
tags:
  - name: AllergyIntolerance
    description: Operations on AllergyIntolerance resources
  - name: CarePlan
    description: Operations on CarePlan resources
  - name: Condition
    description: Operations on Condition resources (diagnoses, problems)
  - name: DiagnosticReport
    description: Operations on DiagnosticReport resources
  - name: DocumentReference
    description: Operations on DocumentReference resources
  - name: Encounter
    description: Operations on Encounter resources
  - name: Immunization
    description: Operations on Immunization resources
  - name: MedicationRequest
    description: Operations on MedicationRequest resources
  - name: Metadata
    description: Server capability and metadata operations
  - name: Observation
    description: Operations on Observation resources (vitals, labs, etc.)
  - name: Patient
    description: Operations on Patient resources
  - name: Procedure
    description: Operations on Procedure resources
paths:
  /metadata:
    get:
      operationId: getCapabilityStatement
      summary: Orion Health Get server capability statement
      description: >-
        Returns the server's CapabilityStatement resource describing the
        FHIR operations, resources, and search parameters supported.
      tags:
        - Metadata
      security: []
      responses:
        '200':
          description: CapabilityStatement resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/CapabilityStatement'
  /Patient:
    get:
      operationId: searchPatients
      summary: Orion Health Search for patients
      description: >-
        Search for Patient resources using standard FHIR search parameters
        including name, identifier, birthdate, gender, and address.
      tags:
        - Patient
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: _id
          in: query
          description: Logical ID of the patient resource
          schema:
            type: string
        - name: identifier
          in: query
          description: 'Patient identifier (e.g., MRN, SSN) in format system|value'
          schema:
            type: string
        - name: family
          in: query
          description: Family (last) name of the patient
          schema:
            type: string
        - name: given
          in: query
          description: Given (first) name of the patient
          schema:
            type: string
        - name: name
          in: query
          description: Any part of the patient name
          schema:
            type: string
        - name: birthdate
          in: query
          description: Patient date of birth (YYYY-MM-DD)
          schema:
            type: string
            format: date
        - name: gender
          in: query
          description: Patient gender
          schema:
            type: string
            enum:
              - male
              - female
              - other
              - unknown
        - name: address
          in: query
          description: Any part of the patient address
          schema:
            type: string
        - name: telecom
          in: query
          description: Patient phone number or email
          schema:
            type: string
      responses:
        '200':
          description: Bundle of matching Patient resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
    post:
      operationId: createPatient
      summary: Orion Health Create a new patient
      description: Create a new Patient resource on the server.
      tags:
        - Patient
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/Patient'
      responses:
        '201':
          description: Patient resource created successfully
          headers:
            Location:
              description: URL of the newly created resource
              schema:
                type: string
            ETag:
              description: Version ID of the resource
              schema:
                type: string
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Patient'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /Patient/{id}:
    get:
      operationId: getPatient
      summary: Orion Health Read a patient by ID
      description: Retrieve a specific Patient resource by its logical ID.
      tags:
        - Patient
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Patient resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Patient'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      operationId: updatePatient
      summary: Orion Health Update a patient
      description: Update an existing Patient resource by its logical ID.
      tags:
        - Patient
      parameters:
        - $ref: '#/components/parameters/ResourceId'
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/Patient'
      responses:
        '200':
          description: Patient resource updated
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Patient'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /Patient/{id}/_history:
    get:
      operationId: getPatientHistory
      summary: Orion Health Get patient version history
      description: Retrieve the version history of a specific Patient resource.
      tags:
        - Patient
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirCount'
      responses:
        '200':
          description: Bundle containing historical versions
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /Encounter:
    get:
      operationId: searchEncounters
      summary: Orion Health Search for encounters
      description: >-
        Search for Encounter resources representing patient visits, admissions,
        and other clinical interactions.
      tags:
        - Encounter
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: date
          in: query
          description: Encounter date or date range
          schema:
            type: string
        - name: status
          in: query
          description: Encounter status
          schema:
            type: string
            enum:
              - planned
              - arrived
              - triaged
              - in-progress
              - onleave
              - finished
              - cancelled
        - name: class
          in: query
          description: Classification of the encounter (e.g., ambulatory, inpatient)
          schema:
            type: string
        - name: type
          in: query
          description: Specific type of encounter
          schema:
            type: string
      responses:
        '200':
          description: Bundle of matching Encounter resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /Encounter/{id}:
    get:
      operationId: getEncounter
      summary: Orion Health Read an encounter by ID
      description: Retrieve a specific Encounter resource by its logical ID.
      tags:
        - Encounter
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Encounter resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Encounter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /Observation:
    get:
      operationId: searchObservations
      summary: Orion Health Search for observations
      description: >-
        Search for Observation resources including vital signs, laboratory results,
        imaging findings, and other clinical measurements.
      tags:
        - Observation
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: category
          in: query
          description: Observation category (e.g., vital-signs, laboratory)
          schema:
            type: string
        - name: code
          in: query
          description: LOINC or SNOMED code for the observation
          schema:
            type: string
        - name: date
          in: query
          description: Observation date or date range
          schema:
            type: string
        - name: status
          in: query
          description: Observation status
          schema:
            type: string
            enum:
              - registered
              - preliminary
              - final
              - amended
              - corrected
              - cancelled
              - entered-in-error
              - unknown
      responses:
        '200':
          description: Bundle of matching Observation resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
    post:
      operationId: createObservation
      summary: Orion Health Create a new observation
      description: Create a new Observation resource.
      tags:
        - Observation
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/Observation'
      responses:
        '201':
          description: Observation resource created successfully
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Observation'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /Observation/{id}:
    get:
      operationId: getObservation
      summary: Orion Health Read an observation by ID
      description: Retrieve a specific Observation resource by its logical ID.
      tags:
        - Observation
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Observation resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Observation'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /Condition:
    get:
      operationId: searchConditions
      summary: Orion Health Search for conditions
      description: >-
        Search for Condition resources representing diagnoses, problems, and
        health concerns.
      tags:
        - Condition
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: code
          in: query
          description: ICD-10 or SNOMED code for the condition
          schema:
            type: string
        - name: clinical-status
          in: query
          description: Clinical status of the condition
          schema:
            type: string
            enum:
              - active
              - recurrence
              - relapse
              - inactive
              - remission
              - resolved
        - name: category
          in: query
          description: Condition category
          schema:
            type: string
        - name: onset-date
          in: query
          description: Date of onset
          schema:
            type: string
      responses:
        '200':
          description: Bundle of matching Condition resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /Condition/{id}:
    get:
      operationId: getCondition
      summary: Orion Health Read a condition by ID
      description: Retrieve a specific Condition resource by its logical ID.
      tags:
        - Condition
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Condition resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Condition'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /MedicationRequest:
    get:
      operationId: searchMedicationRequests
      summary: Orion Health Search for medication requests
      description: >-
        Search for MedicationRequest resources representing prescriptions and
        medication orders.
      tags:
        - MedicationRequest
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: status
          in: query
          description: Prescription status
          schema:
            type: string
            enum:
              - active
              - on-hold
              - cancelled
              - completed
              - entered-in-error
              - stopped
              - draft
              - unknown
        - name: intent
          in: query
          description: Kind of medication request
          schema:
            type: string
        - name: authoredon
          in: query
          description: Date the prescription was written
          schema:
            type: string
      responses:
        '200':
          description: Bundle of matching MedicationRequest resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /MedicationRequest/{id}:
    get:
      operationId: getMedicationRequest
      summary: Orion Health Read a medication request by ID
      description: Retrieve a specific MedicationRequest resource by its logical ID.
      tags:
        - MedicationRequest
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: MedicationRequest resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/MedicationRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /AllergyIntolerance:
    get:
      operationId: searchAllergyIntolerances
      summary: Orion Health Search for allergy intolerances
      description: >-
        Search for AllergyIntolerance resources representing patient allergies
        and adverse reactions.
      tags:
        - AllergyIntolerance
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: clinical-status
          in: query
          description: Clinical status of the allergy
          schema:
            type: string
            enum:
              - active
              - inactive
              - resolved
        - name: type
          in: query
          description: allergy or intolerance
          schema:
            type: string
            enum:
              - allergy
              - intolerance
        - name: criticality
          in: query
          description: Criticality level
          schema:
            type: string
            enum:
              - low
              - high
              - unable-to-assess
      responses:
        '200':
          description: Bundle of matching AllergyIntolerance resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /AllergyIntolerance/{id}:
    get:
      operationId: getAllergyIntolerance
      summary: Orion Health Read an allergy intolerance by ID
      description: Retrieve a specific AllergyIntolerance resource by its logical ID.
      tags:
        - AllergyIntolerance
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: AllergyIntolerance resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/AllergyIntolerance'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /Procedure:
    get:
      operationId: searchProcedures
      summary: Orion Health Search for procedures
      description: >-
        Search for Procedure resources representing clinical procedures
        performed on patients.
      tags:
        - Procedure
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: code
          in: query
          description: CPT or SNOMED code for the procedure
          schema:
            type: string
        - name: date
          in: query
          description: Procedure date or date range
          schema:
            type: string
        - name: status
          in: query
          description: Procedure status
          schema:
            type: string
            enum:
              - preparation
              - in-progress
              - not-done
              - on-hold
              - stopped
              - completed
              - entered-in-error
              - unknown
      responses:
        '200':
          description: Bundle of matching Procedure resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /Procedure/{id}:
    get:
      operationId: getProcedure
      summary: Orion Health Read a procedure by ID
      description: Retrieve a specific Procedure resource by its logical ID.
      tags:
        - Procedure
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Procedure resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Procedure'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /DiagnosticReport:
    get:
      operationId: searchDiagnosticReports
      summary: Orion Health Search for diagnostic reports
      description: >-
        Search for DiagnosticReport resources including lab reports,
        pathology, radiology, and other diagnostic findings.
      tags:
        - DiagnosticReport
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: category
          in: query
          description: Report category (e.g., LAB, RAD)
          schema:
            type: string
        - name: code
          in: query
          description: LOINC code for the report
          schema:
            type: string
        - name: date
          in: query
          description: Report date or date range
          schema:
            type: string
        - name: status
          in: query
          description: Report status
          schema:
            type: string
            enum:
              - registered
              - partial
              - preliminary
              - final
              - amended
              - corrected
              - appended
              - cancelled
              - entered-in-error
              - unknown
      responses:
        '200':
          description: Bundle of matching DiagnosticReport resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /DiagnosticReport/{id}:
    get:
      operationId: getDiagnosticReport
      summary: Orion Health Read a diagnostic report by ID
      description: Retrieve a specific DiagnosticReport resource by its logical ID.
      tags:
        - DiagnosticReport
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: DiagnosticReport resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/DiagnosticReport'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /CarePlan:
    get:
      operationId: searchCarePlans
      summary: Orion Health Search for care plans
      description: >-
        Search for CarePlan resources describing planned healthcare activities
        and goals for patients.
      tags:
        - CarePlan
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: status
          in: query
          description: Care plan status
          schema:
            type: string
            enum:
              - draft
              - active
              - on-hold
              - revoked
              - completed
              - entered-in-error
              - unknown
        - name: category
          in: query
          description: Type of care plan
          schema:
            type: string
        - name: date
          in: query
          description: Care plan period
          schema:
            type: string
      responses:
        '200':
          description: Bundle of matching CarePlan resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /CarePlan/{id}:
    get:
      operationId: getCarePlan
      summary: Orion Health Read a care plan by ID
      description: Retrieve a specific CarePlan resource by its logical ID.
      tags:
        - CarePlan
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: CarePlan resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/CarePlan'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /Immunization:
    get:
      operationId: searchImmunizations
      summary: Orion Health Search for immunizations
      description: >-
        Search for Immunization resources representing vaccine administrations.
      tags:
        - Immunization
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: date
          in: query
          description: Vaccination date or date range
          schema:
            type: string
        - name: vaccine-code
          in: query
          description: CVX code for the vaccine
          schema:
            type: string
        - name: status
          in: query
          description: Immunization status
          schema:
            type: string
            enum:
              - completed
              - entered-in-error
              - not-done
      responses:
        '200':
          description: Bundle of matching Immunization resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /Immunization/{id}:
    get:
      operationId: getImmunization
      summary: Orion Health Read an immunization by ID
      description: Retrieve a specific Immunization resource by its logical ID.
      tags:
        - Immunization
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: Immunization resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Immunization'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /DocumentReference:
    get:
      operationId: searchDocumentReferences
      summary: Orion Health Search for document references
      description: >-
        Search for DocumentReference resources representing clinical documents,
        notes, and reports.
      tags:
        - DocumentReference
      parameters:
        - $ref: '#/components/parameters/FhirFormat'
        - $ref: '#/components/parameters/FhirCount'
        - $ref: '#/components/parameters/FhirOffset'
        - name: patient
          in: query
          description: Reference to the patient
          schema:
            type: string
        - name: type
          in: query
          description: Document type code
          schema:
            type: string
        - name: category
          in: query
          description: Document category
          schema:
            type: string
        - name: date
          in: query
          description: Document date or date range
          schema:
            type: string
        - name: status
          in: query
          description: Document status
          schema:
            type: string
            enum:
              - current
              - superseded
              - entered-in-error
      responses:
        '200':
          description: Bundle of matching DocumentReference resources
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/Bundle'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /DocumentReference/{id}:
    get:
      operationId: getDocumentReference
      summary: Orion Health Read a document reference by ID
      description: Retrieve a specific DocumentReference resource by its logical ID.
      tags:
        - DocumentReference
      parameters:
        - $ref: '#/components/parameters/ResourceId'
        - $ref: '#/components/parameters/FhirFormat'
      responses:
        '200':
          description: DocumentReference resource
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/DocumentReference'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authorization using SMART on FHIR
      flows:
        authorizationCode:
          authorizationUrl: https://auth.orionhealth.com/oauth2/authorize
      

# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/orion/refs/heads/main/openapi/orion-fhir-openapi.yml