Retrieve Subject Clinical Specimen Query Status
get
/HSDataService-web/api/3.2.0/subjectapi/clinicalspecimens/queries/{id}
This endpoint supports the retrieval of Subject Clinical Specimen Query Status for a Query Identifier.
Request
Supported Media Types
- application/json
- application/xml
Path Parameters
- apiContext
-
Type:
string
Required:true
Patient/Subject API context- id
Type:integer
(int64
)Required:true
Query Row ID
Response
Supported Media Types
- application/json
- application/xml
200 Response
successful operation
Body
Root Schema : QueryExecutionStatus
Type:
object
- error
-
Type:
object
QueryJobError - links
-
Type:
array
linksA collection of links containing hrefs to query status and results - queryId
-
Type:
integer
(int64
) - status
-
Type:
string
Nested Schema : QueryJobError
Type:
object
- errorCode
-
Type:
string
- errorMessage
-
Type:
string
400 Response
Invalid request parameters
404 Response
Query status not found
Examples
The following example shows how to view the status of a subject clinical specimen query by submitting a GET request.
API URL
http://localhost:7001/HSDataService-web/api/3.2.0/subjectapi/clinicalspecimens/queries/1002
Example of Response Body
The following example shows the response returned in JSON format.
{ "executeAsync": false, "minRetentionPeriodDays": 5, "queryCriteria": { "allCriteriaList": [ { "type": "DiagnosisCriteria", "exclude": false, "diagnosisCodeList": [ "S280", "M518", "C9000", "C9001", "C900" ] }, { "type": "SequenceVariantsCriteria", "exclude": false, "radioOptionMode": "VARS_IN_GEN_REGION", "genomicPosition": "CHR1:1,200,000-1,900,000", "genomicPositionAlignment": "GRCh37", "variantTypesList": [ { "variantType": "deletion" } ], "polyphenSelected": false, "siftSelected": false, "fileTypeVCFSelected": false, "fileTypeMAFSelected": false, "fileTypeCGISelected": false }, { "type": "HistoryCriteria", "exclude": false, "historyCodeList": [ "9822", "1937", "1" ] } ] }, "queryId": 1002, "queryExecutionStatus": { "status": "DONE", "links": [ { "rel": "status", "href": "/HSDataService-web/api/3.2.0/subjectapi/clinicalspecimens/queries/1002" }, { "rel": "result", "href": "/HSDataService-web/api/3.2.0/subjectapi/clinicalspecimens/queries/1002/data" } ] } }