> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morf.health/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lab Results

> Event payload details and trigger documentation for Lab Results data from Junction

<img src="https://mintlify.s3.us-west-1.amazonaws.com/morfhealth/images/junction.svg" alt="images/junction.svg" />

# Events

## Triggering Webhook Types

The following event types are associated with the Lab Results event payload from Junction.

* `Junction Lab Order Results Update`

<RequestExample>
  ```json Example theme={null}
  {
    "clia_number": "45D0710715",
    "date_collected": "2022-05-15T16:49:00+00:00",
    "date_received": "2022-05-15T00:00:00+00:00",
    "date_reported": "2022-05-20T21:06:00+00:00",
    "interpretation": "abnormal",
    "lab_results": [
      {
        "interpretation": "normal",
        "is_above_max_range": false,
        "is_below_min_range": false,
        "max_range_value": null,
        "min_range_value": null,
        "name": "Glucose",
        "notes": "Final",
        "slug": "glucose",
        "timestamp": "2022-05-17T13:21:00+00:00",
        "unit": "mg/dL",
        "value": null
      }
    ],
    "laboratory": "LabCorp, Inc.",
    "patient": "John",
    "provider": "Doe",
    "specimen_number": "QDWYKK7RAP23",
    "status": "final"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Description theme={null}
  {
    "clia_number": "CLIA number of the laboratory",
    "date_collected": "When the sample was collected",
    "date_received": "When the sample was received by the lab",
    "date_reported": "When the results were reported",
    "interpretation": "Overall interpretation of the results",
    "lab_results": {
      "interpretation": "Interpretation of this result",
      "is_above_max_range": "Whether the value is above the maximum range",
      "is_below_min_range": "Whether the value is below the minimum range",
      "max_range_value": "The high end of the reference range for this test (in the given units)",
      "min_range_value": "The low end of the reference range for this test (in the given units)",
      "name": "Name of the test",
      "notes": "Additional notes about the result",
      "slug": "URL-friendly identifier for the test",
      "timestamp": "When this result was processed",
      "unit": "Unit of measurement",
      "value": "The value of the result (in the given units)"
    },
    "laboratory": "Name of the laboratory",
    "patient": "Name of the patient",
    "provider": "Name of the provider",
    "specimen_number": "Unique identifier for the specimen",
    "status": "Status of the lab results"
  }
  ```
</ResponseExample>

### Payload Field Details

<ResponseField name="Lab Results" type="Event Payload">
  <Expandable title="fields" defaultOpen="true">
    <ResponseField name="clia_number" type="string">
      CLIA number of the laboratory

      ```json CEL theme={null}
      clia_number
      ```

      ```json Example theme={null}
      "45D0710715"
      ```
    </ResponseField>

    <ResponseField name="laboratory" type="string">
      Name of the laboratory

      ```json CEL theme={null}
      laboratory
      ```

      ```json Example theme={null}
      "LabCorp, Inc."
      ```
    </ResponseField>

    <ResponseField name="date_collected" type="timing.v1.Timestamp">
      When the sample was collected

      ```json CEL theme={null}
      date_collected
      ```

      ```json Example theme={null}
      "2022-05-15T16:49:00+00:00"
      ```
    </ResponseField>

    <ResponseField name="date_received" type="timing.v1.Timestamp">
      When the sample was received by the lab

      ```json CEL theme={null}
      date_received
      ```

      ```json Example theme={null}
      "2022-05-15T00:00:00+00:00"
      ```
    </ResponseField>

    <ResponseField name="date_reported" type="timing.v1.Timestamp" required>
      When the results were reported

      ```json CEL theme={null}
      date_reported
      ```

      ```json Example theme={null}
      "2022-05-20T21:06:00+00:00"
      ```
    </ResponseField>

    <ResponseField name="interpretation" type="string">
      Overall interpretation of the results

      ```json CEL theme={null}
      interpretation
      ```

      ```json Example theme={null}
      "abnormal"
      ```
    </ResponseField>

    <ResponseField name="patient" type="string" required>
      Name of the patient

      ```json CEL theme={null}
      patient
      ```

      ```json Example theme={null}
      "John"
      ```
    </ResponseField>

    <ResponseField name="provider" type="string">
      Name of the provider

      ```json CEL theme={null}
      provider
      ```

      ```json Example theme={null}
      "Doe"
      ```
    </ResponseField>

    <ResponseField name="specimen_number" type="string" required>
      Unique identifier for the specimen

      ```json CEL theme={null}
      specimen_number
      ```

      ```json Example theme={null}
      "QDWYKK7RAP23"
      ```
    </ResponseField>

    <ResponseField name="status" type="string">
      Status of the lab results

      ```json CEL theme={null}
      status
      ```

      ```json Example theme={null}
      "final"
      ```
    </ResponseField>

    <ResponseField name="lab_results" type="[]object" required>
      *Description coming soon*

      ```json CEL theme={null}
      lab_results
      ```

      ```json Example theme={null}
      [
      {
      "interpretation": "normal",
      "is_above_max_range": false,
      "is_below_min_range": false,
      "max_range_value": null,
      "min_range_value": null,
      "name": "Glucose",
      "notes": "Final",
      "slug": "glucose",
      "timestamp": "2022-05-17T13:21:00+00:00",
      "unit": "mg/dL",
      "value": null
      }
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.name)" type="[]string" required>
      Mapped array of: Name of the test

      ```json CEL theme={null}
      lab_results.map(x, x.name)
      ```

      ```json Example theme={null}
      [
      "Glucose"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.slug)" type="[]string" required>
      Mapped array of: URL-friendly identifier for the test

      ```json CEL theme={null}
      lab_results.map(x, x.slug)
      ```

      ```json Example theme={null}
      [
      "glucose"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.notes)" type="[]string" required>
      Mapped array of: Additional notes about the result

      ```json CEL theme={null}
      lab_results.map(x, x.notes)
      ```

      ```json Example theme={null}
      [
      "Final"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.timestamp)" type="[]timing.v1.Timestamp" required>
      Mapped array of: When this result was processed

      ```json CEL theme={null}
      lab_results.map(x, x.timestamp)
      ```

      ```json Example theme={null}
      [
      "2022-05-17T13:21:00+00:00"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.value)" type="[]any" required>
      Mapped array of: The value of the result (in the given units)

      ```json CEL theme={null}
      lab_results.map(x, x.value)
      ```

      ```json Example theme={null}
      [
      null
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.unit)" type="[]string" required>
      Mapped array of: Unit of measurement

      ```json CEL theme={null}
      lab_results.map(x, x.unit)
      ```

      ```json Example theme={null}
      [
      "mg/dL"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.interpretation)" type="[]string" required>
      Mapped array of: Interpretation of this result

      ```json CEL theme={null}
      lab_results.map(x, x.interpretation)
      ```

      ```json Example theme={null}
      [
      "normal"
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.is_below_min_range)" type="[]bool" required>
      Mapped array of: Whether the value is below the minimum range

      ```json CEL theme={null}
      lab_results.map(x, x.is_below_min_range)
      ```

      ```json Example theme={null}
      [
      false
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.is_above_max_range)" type="[]bool" required>
      Mapped array of: Whether the value is above the maximum range

      ```json CEL theme={null}
      lab_results.map(x, x.is_above_max_range)
      ```

      ```json Example theme={null}
      [
      false
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.min_range_value)" type="[]any" required>
      Mapped array of: The low end of the reference range for this test (in the given units)

      ```json CEL theme={null}
      lab_results.map(x, x.min_range_value)
      ```

      ```json Example theme={null}
      [
      null
      ]
      ```
    </ResponseField>

    <ResponseField name="lab_results.map(x, x.max_range_value)" type="[]any" required>
      Mapped array of: The high end of the reference range for this test (in the given units)

      ```json CEL theme={null}
      lab_results.map(x, x.max_range_value)
      ```

      ```json Example theme={null}
      [
      null
      ]
      ```
    </ResponseField>
  </Expandable>
</ResponseField>
