Create Lab Order

Endpoint: /v1/lab-orders/create

Method: POST

POST Body

Parameter	Type	Description
OrderType	String	Required. Specifies the type of lab order (e.g., "PGT", "NACE", "POC", "EMMA", "ALICE").
PatientID	String	Required. Patient ID associated with the lab order.
AccountID	String	Required. Account (clinic) ID associated with the lab order.
MedicalHistory	Object	Optional. Contains the patient's medical history.
└─ PreviousConceptions	Number	Optional. Number of previous conceptions (whether successful or not).
└─ PreviousMiscarriages	Number	Optional. Number of previous miscarriages experienced by the patient.
└─ PreviousDeliveries	Number	Optional. Number of previous live births or successful deliveries.
└─ PreviousIVFCycles	Number	Optional. Number of previous IVF treatment cycles undergone by the patient.
CycleInformation	Object	Optional. Details about the patient's IVF or treatment cycle.
└─ PrimaryDiagnosis	String	Optional. Primary diagnosis for the treatment cycle.
└─ FreshTransfer	Boolean	Optional. Indicates if a fresh embryo transfer is planned (true/false).
└─ FreezeAllCycle	Boolean	Optional. Indicates if all embryos will be frozen instead of fresh transfer (true/false).
└─ DonorGametesUsed	Boolean	Optional. Indicates if donor gametes were used in the cycle (true/false).
└─ EggDonorAgeDonorGametesUsed	Number	Optional. Age of the egg donor (required if DonorGametesUsed is true).
└─ SpermDonorAgeDonorGametesUsed	Number	Optional. Age of the sperm donor (required if DonorGametesUsed is true).
└─ EggRetrievalDate	String (YYYY-MM-DD)	Optional. Date of egg retrieval in YYYY-MM-DD format.
└─ MaleFactorInfertility	Boolean	Optional. Indicates male factor infertility (true/false).
TestDetails	Object	Required. Contains details about the requested tests.
└─ PGTDetails	Object	Optional. Details about PGT testing.
└─── ICD10Code	String	Optional. ICD-10 Code for diagnosis (e.g., "O09.511", "N97.9").
└─── PGTA	Boolean	Optional. Indicates if PGT-A testing is requested (true/false).
└─── PGTSR	Boolean	Optional. Indicates if PGT-SR testing is requested (true/false).
└─── MaskSexResults	Boolean	Optional. Indicates if sex results should be masked (true/false).
└─── WithMosaicReporting	Boolean	Optional. Indicates if mosaicism reporting is requested (true/false).
└─── ReasonForTesting	String	Optional. Clinical indication for performing genetic testing (e.g., "Advanced maternal age").
└─ NACEPOCDetails	Object	Optional. Details about NACE or POC testing.
└─── GestationalAge	String	Optional. Gestational age of the fetus (e.g., "8 weeks").
└─── FetalFraction	String	Optional. Percentage of fetal DNA in maternal blood.
└─── TestingIndication	String	Optional. Clinical reason for testing.
└─ EMMAALICEDetails	Object	Optional. Details about EMMA or ALICE testing.
└─── EndometrialMicrobiome	Boolean	Optional. Indicates if testing for the endometrial microbiome is requested (true/false).
└─── PathogenDetection	Boolean	Optional. Indicates if pathogen detection is requested (true/false).
└─── SampleDate	String (YYYY-MM-DD)	Optional. Date of sample collection in YYYY-MM-DD format.
BiopsyDetails	Object	Required. Details about the biopsy process.
└─ EmbryosFertilized	Number	Optional. Total number of embryos fertilized.
└─ EmbryosBiopsied	Number	Required. Total number of embryos biopsied.
└─ BiopsyDate	String (YYYY-MM-DD)	Required. Date of the biopsy.
└─ UID	String	Unique ID for the biopsy process.
└─ LaserHatching	String	Required. Description of laser hatching (if performed).
└─ LaserHatchingComments	String	Optional. Additional comments on laser hatching.
└─ TrackingNumber	String	Optional. Shipment or tracking number for the sample.
└─ BufferLotNumber	String	Optional. Tracks the medium used to store or transport biopsied samples (e.g., "Buffer Lot #123").
└─ Rebiopsied	Boolean	Optional. Indicates if the session is a rebiopsy (true/false).
└─ Comments	String	Optional. Includes any special observations or remarks about the biopsy.
Sample	Object	Optional. Details about the sample.
└─ EmbryoID	String	Optional. Unique ID of the embryo (e.g., "E12345").
└─ TubeBarcode	String	Optional. Barcode on the tube for the sample (e.g., "TB123456").
└─ SampleType	String	Optional. Type of cells removed for testing (e.g., "Blastomere", "Trophectoderm").
└─ ContainerType	String	Optional. Type of container used (e.g., "Cryotube").
└─ DayBiopsied	String	Required. Specifies the day post-fertilization when the biopsy was performed (e.g., "Day 5", "Day 6").
└─ CellsBiopsied	Integer	Required. Number of cells removed during the biopsy (e.g., 5).
└─ CellsVisualizedInTube	Boolean	Optional. Indicates if cells are visible in the tube (true/false).
└─ EmbryoGrade	String	Optional. Reflects embryo quality based on criteria like inner cell mass and trophectoderm quality (e.g., "AA").
└─ DateCollected	Date	Required. Date when the sample was collected (e.g., "2024-01-15").
└─ Stage	String	Optional. Indicates the developmental stage of the embryo during the biopsy (e.g., "Blastocyst").
└─ RebiopsyStatus	Boolean	Optional. Indicates if this is a rebiopsy (true/false).
└─ Comments	String	Optional. Includes any special observations or remarks (e.g., "Testing requested for both PGT-A and PGT-SR.").
BillingTo	String	Optional. allowed values: "Insurance", "Medicare", "Client", "Self-Pay".
Comments	String	Optional. comments or additional information.

Request Body (JSON)

{
    "OrderType": "PGT", // Required: e.g., "PGT", "NACE" "POC" "EMMA" "ALICE"
    "PatientID": "6758f7984546ae79067f7051", // Required. Patient id
    "AccountID": "674a51bf84090f01bec2fda7", // Required. Account (clinic) id
    "MedicalHistory": {
        "PreviousConceptions": 0, // e.g., 2. Number of previous conceptions (whether successful or not)
        "PreviousMiscarriages": 0, // e.g., 1. Number of previous miscarriages experienced by the patient
        "PreviousDeliveries": 0, // e.g., 1. Number of previous live births or successful deliveries
        "PreviousIVFCycles": 0 // e.g., 3. Number of previous IVF treatment cycles undergone by the patient
    },
    "CycleInformation": {
        "PrimaryDiagnosis": "Recurrent pregnancy loss",
        "FreshTransfer": false, // Indicates if a fresh embryo transfer is planned (true/false)
        "FreezeAllCycle": true, // Indicates if all embryos will be frozen instead of fresh transfer
        "DonorGametesUsed": true, // Indicates if donor gametes were used in the cycle (true/false)
        "EggDonorAgeDonorGametesUsed": 30, // e.g., 30. Age of the egg donor, required if DonorGametesUsed is true
        "SpermDonorAgeDonorGametesUsed": 29, // e.g., 35. Age of the sperm donor, required if DonorGametesUsed is true
        "EggRetrievalDate": "2024-01-15" // e.g., "2024-01-15". Date of egg retrieval in YYYY-MM-DD format
    },
    "TestDetails": {
        "PGTDetails": {
            "ICD10Code": "O09.511", // ICD-10 Codes. e.g., "O09.511", "O09.521", "Z87.42", "O26.20", "Q90.9", "Q96.9", "Q99.9", "Q93.9", "Q92.9", "Z31.430", "Z31.440", "N97.9", "Z31.7", "Z31.83", "Z31.81", "N97.2", "N96", "N97.0", "E28.2", "E28.39", "N80.9", "N80.0"
            "PGTA": true, // PGT-A (Preimplantation Genetic Testing for Aneuploidy). Indicates if PGT-A testing is requested (true/false)
            "PGTSR": true, // PGT-SR (Preimplantation Genetic Testing for Structural Rearrangements). Indicates if PGT-SR testing is requested (true/false)
            "MaskSexResults": false, // Indicates if sex results should be masked (true/false)
            "WithMosaicReporting": false, // Indicates if mosaicism reporting is requested (true/false)
            "ReasonForTesting": "Advanced maternal age" // e.g., "Recurrent miscarriages", "Advanced maternal age". Provides the clinical indication for performing genetic testing
        },
        "NACEPOCDetails": {
            "GestationalAge": "", // e.g., "8 weeks"
            "FetalFraction": "", // Percentage of fetal DNA in maternal blood
            "TestingIndication": "" // Clinical reason for testing
        },
        "EMMAALICEDetails": {
            "EndometrialMicrobiome": false, // Indicates testing for endometrial microbiome
            "PathogenDetection": false, // Indicates testing for pathogen
            "SampleDate": "" // Date of sample collection
        }
    },
    "BiopsyDetails": {
        "EmbryosFertilized": 10, // Total number of embryos fertilized
        "EmbryosBiopsied": 5, // Total number of embryos biopsied
        "BiopsyDate": "2024-01-15", // Date of the biopsy
        "UID": "UID12345", // Unique ID for the biopsy process
        "LaserHatching": "Performed", // Description of laser hatching (if performed)
        "LaserHatchingComments": "Applied to embryos E123 and E124", // Additional comments on laser hatching
        "TrackingNumber": "TRK123456", // Shipment or tracking number for the sample
        "BufferLotNumber": "Buffer Lot #123", // e.g., "Buffer Lot #123". Tracks the medium used to store or transport biopsied samples
        "Rebiopsied": false, // Indicates if the entire session is a rebiopsy
        "Comments": "All samples were collected successfully" // Includes any special observations or remarks about the biopsy
    },
    "Comments": "" // Optional comments
}

Responses:

Param	Type
LabOrder	Object
LabOrder.ID	String
LabOrder.AccountID	String
LabOrder.OrderType	String
LabOrder.PatientID	String
LabOrder.MedicalHistory	Object
LabOrder.MedicalHistory.PreviousConceptions	Number
LabOrder.MedicalHistory.PreviousMiscarriages	Number
LabOrder.MedicalHistory.PreviousDeliveries	Number
LabOrder.MedicalHistory.PreviousIVFCycles	Number
LabOrder.CycleInformation	Object
LabOrder.CycleInformation.PrimaryDiagnosis	String
LabOrder.CycleInformation.FreshTransfer	Boolean
LabOrder.CycleInformation.FreezeAllCycle	Boolean
LabOrder.CycleInformation.DonorGametesUsed	Boolean
LabOrder.CycleInformation.EggDonorAgeDonorGametesUsed	Number
LabOrder.CycleInformation.SpermDonorAgeDonorGametesUsed	Number
LabOrder.CycleInformation.EggRetrievalDate	String (Date)
LabOrder.TestDetails	Object
LabOrder.TestDetails.PGTDetails	Object
LabOrder.TestDetails.PGTDetails.ICD10Code	String
LabOrder.TestDetails.PGTDetails.PGTA	Boolean
LabOrder.TestDetails.PGTDetails.PGTSR	Boolean
LabOrder.TestDetails.PGTDetails.MaskSexResults	Boolean
LabOrder.TestDetails.PGTDetails.WithMosaicReporting	Boolean
LabOrder.TestDetails.PGTDetails.ReasonForTesting	String
LabOrder.TestDetails.NACEPOCDetails	Object
LabOrder.TestDetails.NACEPOCDetails.GestationalAge	String
LabOrder.TestDetails.NACEPOCDetails.FetalFraction	String
LabOrder.TestDetails.NACEPOCDetails.TestingIndication	String
LabOrder.TestDetails.EMMAALICEDetails	Object
LabOrder.TestDetails.EMMAALICEDetails.EndometrialMicrobiome	Boolean
LabOrder.TestDetails.EMMAALICEDetails.PathogenDetection	Boolean
LabOrder.TestDetails.EMMAALICEDetails.SampleDate	String
LabOrder.BiopsyDetails	Object
LabOrder.BiopsyDetails.EmbryosFertilized	Number
LabOrder.BiopsyDetails.EmbryosBiopsied	Number
LabOrder.BiopsyDetails.BiopsyDate	String (Date)
LabOrder.BiopsyDetails.UID	String
LabOrder.BiopsyDetails.LaserHatching	String
LabOrder.BiopsyDetails.LaserHatchingComments	String
LabOrder.BiopsyDetails.TrackingNumber	String
LabOrder.BiopsyDetails.BufferLotNumber	String
LabOrder.BiopsyDetails.Comments	String
LabOrder.ApprovalStatus	String
LabOrder.Comments	String
LabOrder.IsDeleted	Boolean
LabOrder.SapioDetails	Object
LabOrder.CreatedBy	String
LabOrder.UpdatedBy	String
LabOrder.CreatedAt	String (DateTime)
LabOrder.UpdatedAt	String (DateTime)
message	String

Success Response (200)

{
    "LabOrder": {
        "ID": "67590322b44ae945786485bb",
        "AccountID": "674a51bf84090f01bec2fda7",
        "OrderType": "PGT",
        "PatientID": "6758f7984546ae79067f7051",
        "MedicalHistory": {
            "PreviousConceptions": 0,
            "PreviousMiscarriages": 0,
            "PreviousDeliveries": 0,
            "PreviousIVFCycles": 0
        },
        "CycleInformation": {
            "PrimaryDiagnosis": "Recurrent pregnancy loss",
            "FreshTransfer": false,
            "FreezeAllCycle": true,
            "DonorGametesUsed": true,
            "EggDonorAgeDonorGametesUsed": 30,
            "SpermDonorAgeDonorGametesUsed": 29,
            "EggRetrievalDate": "2024-01-15"
        },
        "TestDetails": {
            "PGTDetails": {
                "ICD10Code": "O09.511",
                "PGTA": true,
                "PGTSR": true,
                "MaskSexResults": false,
                "WithMosaicReporting": false,
                "ReasonForTesting": "Advanced maternal age"
            },
            "NACEPOCDetails": {
                "GestationalAge": "",
                "FetalFraction": "",
                "TestingIndication": ""
            },
            "EMMAALICEDetails": {
                "EndometrialMicrobiome": false,
                "PathogenDetection": false,
                "SampleDate": ""
            }
        },
        "BiopsyDetails": {
            "EmbryosFertilized": 10,
            "EmbryosBiopsied": 5,
            "BiopsyDate": "2024-01-15",
            "UID": "UID12345",
            "LaserHatching": "Performed",
            "LaserHatchingComments": "Applied to embryos E123 and E124",
            "TrackingNumber": "TRK123456",
            "BufferLotNumber": "Buffer Lot #123",
            "Comments": "All samples were collected successfully"
        },
        "ApprovalStatus": "APPROVED",
        "Comments": "",
        "IsDeleted": false,
        "SapioDetails": {},
        "CreatedBy": "674a42b3f1e7347c79d309e3",
        "UpdatedBy": "674a42b3f1e7347c79d309e3",
        "CreatedAt": "2024-12-11T03:12:34.531Z",
        "UpdatedAt": "2024-12-11T03:12:34.531Z"
    },
    "message": "Lab order created successfully"
}

Error Response (404)

{
    "message": "Patient not found"
}

Error Response (400)

{
    "message": "Invalid API key"
}