Retrieve Genomic Specimen details for a Clinical Specimen Identifier
get
/ohfapi/cg/v3.3/{apiContext}/genomicspecimens/{id}
This endpoint supports the retrieval of Genomic Specimen for a single Clinical Specimen Identifier passed. It returns Genomic Specimen information like Specimen Number, Specimen Vendor Number and other Genomic Specimen associated information.
Request
Supported Media Types
- application/json
- application/xml
Path Parameters
-
apiContext: string
Pattern:
patientapi|subjectapi
-
id: integer(int64)
Minimum Value:
0
Security
-
basicAuth: basic
Type:
basic
Response
Supported Media Types
- application/json
- application/xml
200 Response
successful operation
Root Schema : GenomicSpecimen
Type:
Show Source
object
-
genomicFileMetadata(optional):
object LinkedReference
-
genomicSpecimenMetadata(optional):
object LinkedReference
-
identifier(optional):
object Identifier
Identifier assigned by a given system
-
patient(optional):
object LinkedReference
-
resourceType(optional):
string
-
specimenNumber(optional):
string
Specimen identifier in linked Specimen Datasource Database
-
specimenVendorNumber(optional):
string
Vendor Identifier in linked Specimen Datasource Database
-
subject(optional):
object LinkedReference
Nested Schema : Identifier
Type:
object
Identifier assigned by a given system
Show Source
-
system(optional):
string
System which assigned this identifier
-
value(optional):
string
Identifier value
400 Response
Invalid request parameters
404 Response
Query status not found
Examples
The following example submits a GET request.
API URL ??? Patient Context
http://localhost:7010/ohfapi/cg/v3.3/patientapi/genomicspecimens/10096?limit=20&offset=0
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "resourceType": "GenomicSpecimen", "identifier": { "system": "ODB", "value": "63" }, "specimenNumber": "HG000_10096", "specimenVendorNumber": "vendor2", "genomicSpecimenMetadata": { "reference": "/ohfapi/cg/v3.3/patientapi/genomicspecimens/63/metadata" }, "genomicFileMetadata": { "reference": "/ohfapi/cg/v3.3/patientapi/genomicspecimens/63/fileMetadata" }, "patient": { "reference": "/ohfapi/cg/v3.3/patientapi/patients/2" } }
API URL ??? Subject Context
http://localhost:7010/ohfapi/cg/v3.3/subjectapi/genomicspecimens/1
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "resourceType": "GenomicSpecimen", "identifier": { "system": "ODB", "value": "40001" }, "specimenNumber": "ADME_SPEC1", "specimenVendorNumber": "adme", "genomicSpecimenMetadata": { "reference": "/ohfapi/cg/v3.3/subjectapi/genomicspecimens/40001/metadata" }, "genomicFileMetadata": { "reference": "/ohfapi/cg/v3.3/subjectapi/genomicspecimens/40001/fileMetadata" }, "subject": { "reference": "/ohfapi/cg/v3.3/subjectapi/subjects/7" } }