Create Sample

Endpoint: /v1/lab-orders/samples/create

Method: POST

POST Body

Param	Type	Description
LabOrderID	String	Required. Unique ID of the lab order.
AccountID	String	Required. Unique ID of the account (clinic).
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).
BufferLotNumber	String	Optional. Tracks the medium used to store or transport biopsied samples (e.g., "Buffer Lot #123").
Comments	String	Optional. Includes any special observations or remarks (e.g., "Testing requested for both PGT-A and PGT-SR.").

Request Body (JSON)

{
    "LabOrderID": "67590322b44ae945786485bb", // Required. lab order id
    "AccountID": "674a51bf84090f01bec2fda7", // Required. account (clinic) id
    "EmbryoID": "E12345", // e.g., "E12345". Unique ID of the embryo
    "TubeBarcode": "TB123456", // e.g., "TB123456". Barcode on the tube for the sample
    "SampleType": "Blastomere", // e.g., "Blastomere", "Trophectoderm". Type of cells removed for testing
    "ContainerType": "Cryotube", // e.g., "Cryotube". Type of container used
    "DayBiopsied": "Day 5", // e.g., "Day 5" or "Day 6". Specifies the day post-fertilization when the biopsy was performed
    "CellsBiopsied": 5, // e.g., 5. Number of cells removed during the biopsy
    "CellsVisualizedInTube": true, // Indicates if cells are visible in the tube (true/false)
    "EmbryoGrade": "AA", // e.g., "AA", "AB". Reflects embryo quality based on criteria like inner cell mass and trophectoderm quality
    "DateCollected": "2024-01-15", // e.g., "2024-01-15". Date when the sample was collected
    "Stage": "Blastocyst", // e.g., "Morula", "8-cell", "Blastocyst". Indicates the developmental stage of the embryo during the biopsy
    "RebiopsyStatus": false, // Indicates if this is a rebiopsy (true/false)
    "BufferLotNumber": "Buffer Lot #123", // e.g., "Buffer Lot #123". Tracks the medium used to store or transport biopsied samples
    "Comments": "Testing requested for both PGT-A and PGT-SR." // Includes any special observations or remarks
}

Responses:

Param	Type	Description
message	String	Response message indicating the success of the operation.
Sample	Object	Contains details of the added sample.
Sample.ID	String	Unique identifier for the sample.
Sample.AccountID	String	Unique identifier for the associated account.
Sample.PatientID	String	Unique identifier for the associated patient.
Sample.LabOrderID	String	Unique identifier for the associated lab order.
Sample.EmbryoID	String	Unique identifier for the embryo associated with the sample.
Sample.TubeBarcode	String	Barcode of the tube containing the sample.
Sample.SampleType	String	Type of sample (e.g., Blastomere).
Sample.ContainerType	String	Type of container used for the sample (e.g., Cryotube).
Sample.DayBiopsied	String	Day on which the biopsy was performed (e.g., Day 5).
Sample.CellsBiopsied	Number	Number of cells biopsied from the sample.
Sample.CellsVisualizedInTube	Boolean	Indicates if cells were visualized in the tube.
Sample.EmbryoGrade	String	Grade assigned to the embryo (e.g., AA).
Sample.DateCollected	String (Date)	Date the sample was collected.
Sample.Stage	String	Development stage of the embryo (e.g., Blastocyst).
Sample.RebiopsyStatus	Boolean	Indicates if the sample was re-biopsied.
Sample.Comments	String	Additional comments about the sample.
Sample.IsDeleted	Boolean	Indicates if the sample is marked as deleted.
Sample.CreatedBy	String	ID of the user who created the sample record.
Sample.UpdatedBy	String	ID of the user who last updated the sample record.
Sample.CreatedAt	String (DateTime)	Timestamp when the sample record was created.
Sample.UpdatedAt	String (DateTime)	Timestamp when the sample record was last updated.

Success Response (200)

{
    "Sample": {
        "ID": "675905fa5a175e1a47bd758f",
        "AccountID": "674a51bf84090f01bec2fda7",
        "PatientID": "6758f7984546ae79067f7051",
        "LabOrderID": "67590322b44ae945786485bb",
        "EmbryoID": "E12345",
        "TubeBarcode": "TB123456",
        "SampleType": "Blastomere",
        "ContainerType": "Cryotube",
        "DayBiopsied": "Day 5",
        "CellsBiopsied": 5,
        "CellsVisualizedInTube": true,
        "EmbryoGrade": "AA",
        "DateCollected": "2024-01-15",
        "Stage": "Blastocyst",
        "RebiopsyStatus": false,
        "Comments": "Testing requested for both PGT-A and PGT-SR.",
        "IsDeleted": false,
        "CreatedBy": "674a4310f1e7347c79d309e4",
        "UpdatedBy": "674a4310f1e7347c79d309e4",
        "CreatedAt": "2024-12-11T03:24:42.042Z",
        "UpdatedAt": "2024-12-11T03:24:42.042Z"
    },
    "message": "Sample added successfully"
}