Testkit Status Details - Junction

Overview

When a testkit order enters a problem or blocked state, the API surfaces additional detail beyond the order event status. This page describes the named status details and what they mean.

Please note: To ensure future compatibility, avoid exhaustive matching on status detail values. New values may be introduced over time. Handle unknown values gracefully using a default case.

Lab Processing

These status details apply after the lab has received the sample but cannot proceed with processing. Most are recoverable if the missing information is provided before the specimen expires.

Status Detail	Description	Permanence	Detection
Missing date of collection	Lab received the sample but the collection date is absent.	Temporary	Programmatic (lab notification)
Missing documentation / ID form	Lab received the sample but required paperwork is missing.	Temporary	Programmatic (lab notification)
Demographic mismatch	Name or date of birth on the specimen does not match the order. Requires patient confirmation.	Temporary	Programmatic (lab notification)
NIS (Not In System)	Lab cannot match the specimen to a known order. Requires ops investigation. May be recoverable.	Temporary	Programmatic (lab notification)

API field values — Lab Processing

Problem	`status`	`status_detail`
Missing date of collection	`lab_processing_blocked`	`date_of_collection_unspecified`
Missing documentation / ID form	`lab_processing_blocked`	`demographic_information_unspecified`
Demographic mismatch	`lab_processing_blocked`	`demographic_information_mismatch`
NIS (Not In System)	`lab_processing_blocked`	—

Sample Errors

These status details indicate the collected sample could not be processed by the lab. All are final — a new kit and recollection are required.

Status Detail	Description	Detection
QNS (Quantity Not Sufficient)	Insufficient blood volume was collected.	Programmatic (lab notification)
Contaminated specimen	Sample was contaminated during collection or transit.	Programmatic (lab notification)
Specimen too old / stability exceeded	Too much time elapsed between collection and processing — sample has degraded.	Programmatic (lab notification)
Specimen mislabeled	Identification discrepancy between the specimen and the requisition. Results are discarded.	Programmatic (lab notification)
Specimen lost by lab	Lab reports the specimen was lost after receipt.	Programmatic (lab notification)
Partial results	Lab could only process a subset of ordered tests. Remaining tests may require recollection.	Programmatic (lab notification)

API field values — Sample Errors

Problem	`status`	`status_detail`
QNS (Quantity Not Sufficient)	`sample_error`	`sample_quantity_not_sufficient`
Contaminated specimen	`sample_error`	`sample_contaminated`
Improper collection	`sample_error`	`sample_improper_collection`
Specimen hemolyzed	`sample_error`	`sample_hemolyzed`
Specimen too old / stability exceeded	`sample_error`	`sample_stability_exceeded`
Specimen mislabeled	`sample_error`	—