Retrieve Subject Clinical Specimen Using Query Criteria
post
/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries
This endpoint supports the retrieval of all specimens of the subjects identified for this query criteria. It returns Status information like Reference Links to Execution Status for checking Progress and to Access Results when the execution is done. Note: In future release this API would retrieve only the specimen which fall under the query criteria and not just all specimen of subjects identified for this criteria.
Request
Supported Media Types
- application/json
- application/xml
Cohort Query Name,Creation Date,Retention Date Details for Subject
Nested Schema : AllCriteriaList
Type:
object
Contains all the Query Criteria
Show Source
-
allCriteriaList:
array allCriteriaList
Minimum Number of Items:
1
Maximum Number of Items:2147483647
List of Criteria Eg.DemographicsCriteria,MedicationCriteria,DiagnosisCriteria,SequenceVariantsCriteria,ConsentCriteria,DiagnosisCriteria,EncounterCriteria,ObservationCriteria,HistoryCriteria,ProceduresCriteria,SpecimenCriteria,StudyCriteria,MicroarrayExpressionCriteria,RNASeqExpressionCriteria,CopyNumberVariationCriteria,RelativeTimeEventsCriteria
Nested Schema : allCriteriaList
Type:
array
Minimum Number of Items:
1
Maximum Number of Items:
2147483647
List of Criteria Eg.DemographicsCriteria,MedicationCriteria,DiagnosisCriteria,SequenceVariantsCriteria,ConsentCriteria,DiagnosisCriteria,EncounterCriteria,ObservationCriteria,HistoryCriteria,ProceduresCriteria,SpecimenCriteria,StudyCriteria,MicroarrayExpressionCriteria,RNASeqExpressionCriteria,CopyNumberVariationCriteria,RelativeTimeEventsCriteria
Show Source
-
Array of:
object criteria
Discriminator:
type
Security
-
basicAuth: basic
Type:
basic
Response
Supported Media Types
- application/json
- application/xml
200 Response
successful operation
Nested Schema : UriBuilder
Type:
object
202 Response
Query accepted
400 Response
Invalid Parameters
406 Response
Failed to accept query
Examples
The following example submits a POST request. See the Criteria Classes for this endpoint.
API URL
http://localhost:7010/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries
Example of Request Body
The following example shows the request sent in JSON format.
{ "queryCriteria" : { "allCriteriaList" : [ { "type" : "DiagnosisCriteria", "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" } ] } , { "type" : "HistoryCriteria", "historyCodeList": ["9822","1937","1"] } ] } }
Example of Request Body
The following example shows the response returned in JSON format.
[ { "rel": "status", "href": "/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries/1002" }, { "rel": "result", "href": "/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries/1002/data" } ]