Saga IT API

openapi: 3.1.0
info:
  title: Saga IT API
  version: '2026-10-21'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-21: 20 operation(s) read from 14 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Saga IT has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 6
    documentation: 14
    pages-with-code: 6
    pages-read: 14
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-21'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://saga-it.com/docs/mirthsync/vscode/reference
  - https://saga-it.com/services/fhir-api-integration
  - https://saga-it.com/docs/mirthsync/cli/setup
  - https://saga-it.com/docs/mirthsync/cli/installation
  - https://saga-it.com/docs/mirthsync/guides/ci-cd-setup
  - https://saga-it.com/docs/mirthsync/faq
  - https://saga-it.com/docs/mirthsync/cheat-sheet
  - https://saga-it.com/company/about
  - https://saga-it.com/services/healthcare-interoperability
  - https://saga-it.com/services/hl7-integration
  - https://saga-it.com/services/cms-interoperability
  - https://saga-it.com/services/tefca-integration
  - https://saga-it.com/services/ehr-integration
  - https://saga-it.com/services/epic-integration
paths:
  /Condition:
    get:
      operationId: get_Condition
      tags:
      - Condition
      summary: GET /Condition searches for Condition resources, e.g., by patient.
      x-source: https://saga-it.com/services/fhir-api-integration
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConditionResponse'
      x-evidence:
        kind: documentation
  /Coverage:
    get:
      operationId: get_Coverage
      tags:
      - Coverage
      summary: CMS Interoperability & Information Blocking Consulting — Saga IT
      x-source: https://saga-it.com/services/cms-interoperability
      parameters:
      - name: beneficiary
        in: query
        required: false
        schema:
          type: string
        description: beneficiary identifier
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /DocumentReference:
    get:
      operationId: get_DocumentReference
      tags:
      - Documentreference
      summary: Epic EHR GET /ImagingStudy?patient={id} and GET /DocumentReference?category=clinical-note
      x-source: https://saga-it.com/company/about
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
        description: Category filter, e.g., clinical-note
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ExplanationOfBenefit:
    get:
      operationId: get_ExplanationOfBenefit
      tags:
      - Explanationofbenefit
      summary: CMS Interoperability & Information Blocking Consulting — Saga IT
      x-source: https://saga-it.com/services/cms-interoperability
      parameters:
      - name: patient
        in: query
        required: false
        schema:
          type: string
        description: patient identifier
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ImagingStudy:
    get:
      operationId: get_ImagingStudy
      tags:
      - Imagingstudy
      summary: Epic EHR GET /ImagingStudy?patient={id} and GET /DocumentReference?category=clinical-note
      x-source: https://saga-it.com/company/about
      parameters:
      - name: patient
        in: query
        required: false
        schema:
          type: string
        description: Patient identifier
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /MedicationRequest:
    get:
      operationId: get_MedicationRequest
      tags:
      - Medicationrequest
      summary: GET /MedicationRequest retrieves MedicationRequest resources, e.g., filtered by patient and status.
      x-source: https://saga-it.com/services/fhir-api-integration
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMedicationrequestResponse'
      x-evidence:
        kind: documentation
  /Patient/{id}:
    get:
      operationId: get_Patient_id
      tags:
      - Patient
      summary: GET /Patient/{id} retrieves a Patient resource.
      x-source: https://saga-it.com/services/fhir-api-integration
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPatientIdResponse'
      x-evidence:
        kind: documentation
  /SagaHealthcareIT/mirthsync/releases/download/$(MIRTHSYNC_VERSION:
    get:
      operationId: get_SagaHealthcareIT_mirthsync_releases_download_MIRTHSYNC_VERSION
      tags:
      - Sagahealthcareit
      summary: GET /SagaHealthcareIT/mirthsync/releases/download/$(MIRTHSYNC_VERSION
      x-source: https://saga-it.com/docs/mirthsync/guides/ci-cd-setup
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -L -o mirthsync.zip https://github.com/SagaHealthcareIT/mirthsync/releases/download/$(MIRTHSYNC_VERSION)/mirthsync-$(MIRTHSYNC_VERSION).zip\
          \ unzip mirthsync.zip chmod +x mirthsync-$(MIRTHSYNC_VERSION)/bin/mirthsync.sh displayName : \" Download MirthSync \" \n - script :\
          \ ./mirthsync-$(MIRTHSYNC_VERSION)/bin/mirthsync.sh -s $(DEV_MIRTH_SERVER) -u $(DEV_MIRTH_USERNAME) -t . --deploy-all push display"
  /SagaHealthcareIT/mirthsync/releases/download/$(MIRTHSYNC_VERSION)/mirthsync-$(MIRTHSYNC_VERSION).zip:
    get:
      operationId: get_SagaHealthcareIT_mirthsync_releases_download_MIRTHSYNC_VERSION_mirthsync_MIR
      tags:
      - Sagahealthcareit
      summary: Download MirthSync
      x-source: https://saga-it.com/docs/mirthsync/guides/ci-cd-setup
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSagahealthcareitMirthsyncReleasesDownloadMirthsyncVersion'
      x-evidence:
        kind: documentation
  /SagaHealthcareIT/mirthsync/releases/download/${MIRTHSYNC_VERSION}/mirthsync-${MIRTHSYNC_VERSION}.zip:
    get:
      operationId: get_SagaHealthcareIT_mirthsync_releases_download_MIRTHSYNC_VERSION_mirthsync_MIR
      tags:
      - Sagahealthcareit
      summary: GET /SagaHealthcareIT/mirthsync/releases/download/${MIRTHSYNC_VERSION}/mirthsync-${MIRTHSYNC_VERSION}.zip
      x-source: https://saga-it.com/docs/mirthsync/guides/ci-cd-setup
      parameters:
      - name: MIRTHSYNC_VERSION
        in: path
        required: true
        schema:
          type: string
      - name: MIRTHSYNC_VERSION
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -L -o mirthsync.zip https://github.com/SagaHealthcareIT/mirthsync/releases/download/${MIRTHSYNC_VERSION}/mirthsync-${MIRTHSYNC_VERSION}.zip\
          \ unzip mirthsync.zip chmod +x mirthsync-${MIRTHSYNC_VERSION}/bin/mirthsync.sh \n - name : Deploy to Production run : ./mirthsync-${MIRTHSYNC_VERSION}/bin/mirthsync.sh\
          \ -s ${{secrets.MIRTH_SERVER}} -u ${{secrets.MIRTH_USERNAME}} -t . --deploy-all push env : M"
  /SagaHealthcareIT/mirthsync/releases/download/3.8.0/mirthsync-3.8.0.zip:
    get:
      operationId: get_SagaHealthcareIT_mirthsync_releases_download_3_8_0_mirthsync_3_8_0_zip
      tags:
      - Sagahealthcareit
      summary: GET /SagaHealthcareIT/mirthsync/releases/download/3.8.0/mirthsync-3.8.0.zip
      x-source: https://saga-it.com/docs/mirthsync/cli/installation
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -L -o mirthsync.zip https://github.com/SagaHealthcareIT/mirthsync/releases/download/3.8.0/mirthsync-3.8.0.zip unzip mirthsync.zip\
          \ ./mirthsync-3.8.0/bin/mirthsync.sh -V \n The examples on these pages use java -jar mirthsync.jar . That is the same jar, from lib/mirthsync-X.X.X-standalone.jar\
          \ , copied or renamed. \n Create an Alias For convenience, create an alias in your shell profile: Terminal w"
  /api:
    get:
      operationId: get_api
      tags:
      - Api
      summary: GET /api
      x-source: https://saga-it.com/docs/mirthsync/cli/installation
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://mirth.example.com:8443/api should respond \n Check firewall: Ensure port 8443 is open between your machine and\
          \ the server \n VPN required? Some organizations require VPN to access Mirth servers \n Next Steps Section titled “Next Steps” \n Continue\
          \ to Setup Guide Now that MirthSync is installed, the Setup Guide will walk you through: \n Pulling configurations from your Mirth Connect\
          \ or OIE "
  /api/server/version:
    get:
      operationId: get_api_server_version
      tags:
      - Api
      summary: GET /api/server/version
      x-source: https://saga-it.com/docs/mirthsync/vscode/reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -k https://hostname:8443/api/server/version \n Check credentials with MirthSync: Test Connection \n For self-signed certificates,\
          \ enable mirthsync.ignoreCertificateWarnings (development only) \n Increase mirthsync.defaultTimeout for slow networks \n Sync Conflicts\
          \ Section titled “Sync Conflicts” \n Symptoms: Push fails with conflict errors. \n Pull the latest server state first: MirthSync: Pull\
          \ All"
  /api/system/info:
    get:
      operationId: get_api_system_info
      tags:
      - Api
      summary: GET /api/system/info
      x-source: https://saga-it.com/docs/mirthsync/faq
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -u admin:admin https://mirth.example.com:8443/api/system/info \n Check MIRTHSYNC_PASSWORD environment variable (only\
          \ supported env var) \n Terminal window env | grep MIRTHSYNC \n Verify user has API access \n Log into Mirth Connect Administrator \n\
          \ Go to Settings → Users \n Verify user has “REST API” permission \n Check for special characters in password \n Terminal window # Use\
          \ single quotes to"
  /authorize:
    get:
      operationId: get_authorize
      tags:
      - Authorize
      summary: SMART on FHIR Patient Portal Launch
      x-source: https://saga-it.com/services/ehr-integration
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /cds-services:
    post:
      operationId: post_cds_services
      tags:
      - Cds Services
      summary: POST /cds-services receives CDS Hook requests and returns cards.
      x-source: https://saga-it.com/services/fhir-api-integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCdsServicesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCdsServicesResponse'
      x-evidence:
        kind: documentation
  /cds-services/sepsis-risk:
    post:
      operationId: post_cds_services_sepsis_risk
      tags:
      - Cds Services
      summary: CDS Hooks service for sepsis risk assessment
      x-source: https://saga-it.com/services/epic-integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCdsServicesSepsisRiskRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /query:
    post:
      operationId: post_query
      tags:
      - Query
      summary: Provider Request POST /query
      x-source: https://saga-it.com/services/tefca-integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQueryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /smart/launch:
    get:
      operationId: get_smart_launch
      tags:
      - Smart
      summary: SMART on FHIR launch
      x-source: https://saga-it.com/services/epic-integration
      parameters:
      - name: iss
        in: query
        required: true
        schema:
          type: string
        description: FHIR server base URL
      - name: launch
        in: query
        required: true
        schema:
          type: string
        description: Launch token encoding clinical context
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /status:
    get:
      operationId: get_status
      tags:
      - Status
      summary: GET /status returns 200 with download URLs for Bulk FHIR export.
      x-source: https://saga-it.com/services/fhir-api-integration
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStatusResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetConditionResponse:
      type: object
      properties:
        '200':
          type: string
          description: OK
    GetMedicationrequestResponse:
      type: object
      properties:
        '200':
          type: string
          description: OK
    GetPatientIdResponse:
      type: object
      properties:
        '200':
          type: string
          description: OK
    GetSagahealthcareitMirthsyncReleasesDownloadMirthsyncVersion:
      type: object
      properties:
        '200':
          type: string
          description: Successful download
    PostCdsServicesRequest:
      type: object
      properties:
        cards:
          type: array
      required:
      - cards
    PostCdsServicesResponse:
      type: object
      properties:
        '200':
          type: string
          description: OK
    PostCdsServicesSepsisRiskRequest:
      type: object
      properties:
        context:
          type: string
          description: Contains patient and draftOrders data
      required:
      - context
    PostQueryRequest:
      type: object
      properties:
        purpose:
          type: string
        patient:
          type: object
          description: Patient information
        patient.family:
          type: string
        patient.birthDate:
          type: string
          description: Date in YYYY-MM-DD format
      required:
      - purpose
      - patient
    GetStatusResponse:
      type: object
      properties:
        '200':
          type: string
          description: OK
  securitySchemes:
    Mirth_Connect_API:
      type: http
      scheme: basic
      x-source: https://saga-it.com/docs/mirthsync/cli/setup
tags:
- name: Api
- name: Authorize
- name: Cds Services
- name: Condition
- name: Coverage
- name: Documentreference
- name: Explanationofbenefit
- name: Imagingstudy
- name: Medicationrequest
- name: Patient
- name: Query
- name: Sagahealthcareit
- name: Smart
- name: Status
security:
- Mirth_Connect_API: []