> ## 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.

# Order

> Event payload details and trigger documentation for Order data from Butterfly Labs

<img src="https://mintcdn.com/morfhealth/EU2WCxuXGIUQcziR/images/butterfly_labs.svg?fit=max&auto=format&n=EU2WCxuXGIUQcziR&q=85&s=d8df90f1ab43f8a78a7ae6a4446e8923" alt="images/butterfly_labs.svg" width="40" height="40" data-path="images/butterfly_labs.svg" />

# Events

## Triggering Webhook Types

The following event types are associated with the Order event payload from Butterfly Labs.

* `Butterfly Labs Lab Order Status Update`

<RequestExample>
  ```json Example theme={null}
  {
    "created_at": "2023-02-16T03:49:39.667Z",
    "definition_code": "BFLY-21H1XI",
    "definition_encounter_type": "HOME_VISIT_WITH_KIT",
    "definition_name": "Follow-Up Panel",
    "id": "ord_Lmx2DbrO0pvPBjMaH1d8gBx",
    "patient_email_address": "test@morf.health",
    "patient_id": "pt_G2d42kA1JrNppciYEE",
    "status": "RESULTS_READY",
    "updated_at": "2023-03-06T16:53:23.835Z"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Description theme={null}
  {
    "created_at": "When this order was created",
    "definition_code": "Code identifying the type of lab order",
    "definition_encounter_type": "Type of encounter for this order",
    "definition_name": "Human-readable name of the order type",
    "id": "Unique identifier for the order",
    "patient_email_address": "Email address of the patient",
    "patient_id": "ID of the patient this order is for",
    "status": "Current status of the order",
    "updated_at": "When this order was last updated"
  }
  ```
</ResponseExample>

### Payload Field Details

<ResponseField name="Order" type="Event Payload">
  <Expandable title="fields" defaultOpen="true">
    <ResponseField name="id" type="string" required>
      Unique identifier for the order

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

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

    <ResponseField name="patient_id" type="string" required>
      ID of the patient this order is for

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

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

    <ResponseField name="patient_email_address" type="string" required>
      Email address of the patient

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

      ```json Example theme={null}
      "test@morf.health"
      ```
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Current status of the order

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

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

    <ResponseField name="definition_code" type="string" required>
      Code identifying the type of lab order

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

      ```json Example theme={null}
      "BFLY-21H1XI"
      ```
    </ResponseField>

    <ResponseField name="definition_encounter_type" type="string" required>
      Type of encounter for this order

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

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

    <ResponseField name="definition_name" type="string" required>
      Human-readable name of the order type

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

      ```json Example theme={null}
      "Follow-Up Panel"
      ```
    </ResponseField>

    <ResponseField name="created_at" type="timing.v1.Timestamp" required>
      When this order was created

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

      ```json Example theme={null}
      "2023-02-16T03:49:39.667Z"
      ```
    </ResponseField>

    <ResponseField name="updated_at" type="timing.v1.Timestamp" required>
      When this order was last updated

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

      ```json Example theme={null}
      "2023-03-06T16:53:23.835Z"
      ```
    </ResponseField>
  </Expandable>
</ResponseField>