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" }]
}

Still need help? Contact Us Contact Us