MRD Monitoring

 Important

MRD products and their corresponding fields are still hidden from the production API. The documentation is already live here to assist partners during the testing phase.

Myriad Precise MRD™ Monitoring orders are used to track a patient's treatment response over time after an initial Myriad Precise MRD™ Baseline order has been submitted. Each monitoring order is linked to the original baseline order via relatedOrderRequisitionNumber.

Key Fields

products: [{ product: MRDMONITORING }] — selects the MRD Monitoring product
relatedOrderRequisitionNumber — the requisition number of the previously submitted MRD Baseline order, used internally by Myriad to link the patient's monitoring and baseline together
clinical.treatmentTimepoint — when clinical data was collected (ADJUVANT, METASTATIC, NEOADJUVANT, SURVEILLANCE, OTHER)
specimens.mrdblood — MRD blood specimen with collection ownership and hospitalization details
- initialCollectionOwner — who manages the initial sample collection (MYRIAD or PROVIDER)
- futureCollectionOwner — who manages future monitoring sample collections (MYRIAD or PROVIDER)
- hospitalizationCode — patient's hospitalization status (HOSPITAL_INPATIENT, HOSPITAL_OUTPATIENT, NON_HOSPITAL_PATIENT)
- hospitalDischargeDate — required when hospitalizationCode is HOSPITAL_INPATIENT

Monitoring Order

An example payload showing proper placement of the above fields.

mutation createOrder {
  createOrder(
    order: {
      billing: { institution: { institutionalAccountNumber: "123456789" } }
      clinical: {
        monitoringSequence: EVERY_3_MONTHS
        treatmentTimepoint: ADJUVANT
        personalCancerHistory: [
          {
            breastDCIS: {
                diagnosisAge: 56
                diagnosisDate: "1970-01-01"
                diagnosisDetails: {
                  left: true
                  right: false
                  cancerSeverity: [
                    METASTATIC
                  ]
                }
                primaryTumorDiagnosis: true
              }
          }
        ]
      }
      patient: {
        address: { city: "Salt Lake City", postalCode: "84101", stateCode: UT, street: "320 Wakara Way" }
        dob: "1975-03-22"
        firstName: "Jane"
        genderCode: FEMALE
        lastName: "Smith"
        mobilePhoneNumber: "801-555-1234"
      }
      products: [{ product: MRDMONITORING }]
      providerAccounts: [
        {
          provider: {
            firstName: "Test"
            lastName: "Provider"
            identifiers: [{ type: NPI, use: OFFICIAL, value: "12345" }]
          }
          location: { address: { city: "Salt Lake City", postalCode: "84101", stateCode: UT, street: "320 Wakara Way" } }
          organization: { identifiers: [{ type: XX, use: OFFICIAL, value: "12345" }] }
          role: ORDERING
        }
      ]
      relatedOrderRequisitionNumber: "mrd-baseline-001"
      requisitionNumber: "mrd-monitoring-001"
      specimens: [
        {
          mrdblood: {
            collectionDate: "2025-08-01"
            initialCollectionOwner: PROVIDER
            futureCollectionOwner: PROVIDER
            hospitalizationCode: HOSPITAL_OUTPATIENT
          }
        }
      ]
    }
  ) {
    id
  }
}

MRD Baseline Attachments