Retrieve Lab Order Results
For retrieving a list of test result ready orders
URL : /TestResult
URL Parameters :
Parameter | Required | Accepted Values |
---|---|---|
lob |
x | SC, ID, DNA, FIT, CGX |
order_number |
order number used when placing an order |
Method : GET
Auth required : YES
List All Orders With Reports Ready
[ "1234", "2234" ]
only list order_number for the orders that have test result ready for reported last 7 days.
Retrieve Test Result Details
?lob="SC"&order_number="1234"
Responses
Example Failure Response
{ "order_number": "1234", "success": false, "error_msg": null, "current_status": "in process" }
current_status
– includes “not received yet”, “in process”, “rejected”, “cancelled” & “report ready”
Example Success Response
Only reply "success"=true
, when test results are ready
SC Success
{ "order_number": "123123", "accession_number": "M000000001", "success": true, "current_status": "report ready", "patient_date_of_birth": "1976-01-01", "report_sent_datetime": "2018-06-12T23:15:24.017Z", "tempstrip_status": "", "observations": [{ "test_id": 16, "test_name": "Chlamydia trachomatis (CT)", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }, { "test_id": 8, "test_name": "Neisseria gonorrhea (NG)", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }, { "test_id": 9, "test_name": "Trichomonas vaginalis (TV)", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }, { "test_id": 38, "test_name": "Human Immunodeficiency Virus (HIV)", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }, { "test_id": 36, "test_name": "Hepatitis C Virus (HCV)", "result": "Not Detected", "snp": """", "result_value": "", "assay_datetime": "" }, { "test_id": 30, "test_name": "Herpes Simplex Virus, type II (HSV2)", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }, { "test_id": 31, "test_name": "Syphilis", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }], "attachments": [{ "file_name": "M000000001_06122018031248.pdf", "content_type": "application/pdf", "data": "Base 64 encode" }] }
DNA Success
raw data/report will be provided based on the contract.
{ "order_number": "123123", "accession_number": "DE00000001", "success": true, "current_status": "report ready", "patient_date_of_birth": "1976-01-01", "report_sent_datetime": "2018-06-12T23:15:24.017Z", "tempstrip_status": "", "observations": [{ "test_id": 21, "test_name": "ANKK1", "result": "G/G", "snp": "rs1800497", "result_value": "", "assay_datetime": "" }, { "test_id": 12, "test_name": "COMT", "result": "A/G", "snp": "rs4680", "result_value": "", "assay_datetime": "" }, { "test_id": 56, "test_name": "DBH", "result": "C/C", "snp": "rs1611115", "result_value": "", "assay_datetime": "" }, { "test_id": 14, "test_name": "OPRM1", "result": "A/A", "snp": "rs1799971", "result_value": "", "assay_datetime": "" }], "attachments": [{ "file_name": "DE00000001_Addiction_1007.pdf", "content_type": "application/pdf", "data": "Base 64 encode" }, { "file_name": "DE00000001_Cardiovascular_1007.pdf", "content_type": "application/pdf", "data": "Base 64 encode" }] }
FIT/CGx Success
only report will be provided for Fitness orders
{ "order_number": "123123", "accession_number": "PH00000001", "success": true, "current_status": "report ready", "patient_date_of_birth": "1976-01-01", "report_sent_datetime": "2018-06-12T23:15:24.017Z", "tempstrip_status": "", "observations": [], "attachments": [{ "file_name": "PH00000001_1007.pdf", "content_type": "application/pdf", "data": "Base 64 encode" }] }
ID Success
tempstrip_status
– includes Ok, Overheated, Frozen & Not Used (no tag in the kit), only has value in ID.
{ "order_number": "0002", "accession_number": "ID19012198", "success": true, "current_status": "report ready", "patient_date_of_birth": "1962-06-03", "report_sent_datetime": "2019-10-18T22:47:49.393Z", "tempstrip_status": "Ok", "observations": [{ "test_id": 295, "test_name": "Flu A", "result": "Detected", "snp": "", "result_value": "31.1", "assay_datetime": "2019-10-18T22:47:49.393Z" }, { "test_id": 296, "test_name": "Flu B", "result": "Detected", "snp": "", "result_value": "31.1", "assay_datetime": "2019-10-18T22:47:49.393Z" }, { "test_id": 297, "test_name": "RSV", "result": "Not Detected", "snp": "", "result_value": "", "assay_datetime": "" }], "attachments": [{ "file_name": "ID_MockReport.pdf", "content_type": "application/pdf", "data": " Base 64 encode" }] }