This API is used to create derived specimen requirements.
| URL | /openspecimen/rest/ng/specimen-requirements/{parent-req-id}/derived | ||
| Method | POST | ||
| Body |
|
Response
HTTP Status Code | Description |
|---|---|
| 200 | The derived specimen requirement is created and is assigned a unique ID. The response body contains the requirement details along with the unique ID. This unique ID can be used later to update, retrieve or create aliquots. |
| 400 | Something incorrect with the request. The response body contains the error code and the human readable error message. |
| 500 | Something wrong with the server. Please contact support along with the request payload and exception stack trace. |
Request Parameters
Parameter | Description |
|---|---|
| code | Unique code assigned to the specimen within the event/visit. Useful in generation of specimen labels, generating collection reports, and bulk importing planned specimen records. For this, CP coding setting needs to be enabled. |
| specimenClass | Specimen class. Fluid, Cell, Molecular, Tissue. |
| type | Specifies the type of specimen. Example: Whole Blood, Fresh Tissue etc. The value should be one of the allowed values configured in the PV list for specimen type. |
| anatomicSite | The part of the body from which the specimen was retrieved. Example Cerebrum, Liver etc |
laterality | The side of the part from which the specimen was retrieved. Example - Left, Right etc |
| pathology | Indicates whether the specimen is cancerous. Example - Malignant, Non-Malignant etc |
| quantity | Quantity of specimen to be collected. Example: 10 ml of Whole Blood |
| concentration | Mostly relevant for molecular specimens like DNA, RNA to determine the purity of samples. |