Skip to main content

Flat File Integrations - External Observations

File Name​

When sending the file to the server it should be named using the following format: "observations_{timestamp}.csv"

Which Data​

Any data that can be mapped to a Mirah assessment (see below). Note that Observations include only the final value, and not any individual item responses used to generate the final result.

Data Fields​

*Note: Please follow all field name and note formats, including case sensitivity.

ItemField nameFormatReq’dNotes
IdidentifiersstringYUnique ID for the observation
Subject IdsubjectIdstringYThis should be a guaranteed-unique identifier for the patient in your EHR that is associated with the caregiver
Effective DateeffectiveDateFHIR dateTimeYThe date the observation was completed
CodecodestringYThe code representing the assessment that was completed. Please see “Assessment Codes” below
Value (Float)valueFloatfloatNOne of valueFloat, valueInt and valueString is required. The value of the assessment
Value (Int)valueIntintegerNOne of valueFloat, valueInt and valueString is required. The value of the assessment
Value (String)valueStringstringNOne of valueFloat, valueInt and valueString is required. The value of the assessment
PerformerperformerFHIR referenceNIf left blank, the performer is assumed to be the patient. Will accept FHIR references for Patient, RelatedPerson, and Practitioner, e.g.:Patient/123RelatedPerson/456Practitioner/789
NotenotestringNAny notes to be displayed with the observation
InterpretationinterpretationstringNThe interpretation of the result, in string format.
Encounter IdencounterIdstringNThe identifier of the encounter to associate this measurement with

Assessment Codes

Mirah supports over 400 assessments. We support three different mechanisms for matching:

  • LOINC codes - e.g. 44261-6 for the PHQ9
  • Mirah’s unique assessment code. Examples include ‘phq9’, ‘gad7’, ‘sfss’, etc. A full code mapping can be provided on request.
  • A custom mapping agreed with our support team as part of implementation.

For customers using just the PHQ9 and GAD7, they may use the string ‘phq9’ for PHQ9 and ‘gad7’ for GAD7.