Clinical Genomic APIs for Oracle Healthcare Foundation

Retrieve Subject Clinical Specimen Query Status

get

/ohfapi/cg/v3.3/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: string

Patient/Subject API context
id: integer(int64)

Query Row ID

Security

basicAuth: basic

Type: basic

Response

Supported Media Types

application/json
application/xml

200 Response

successful operation

Root Schema : QueryExecutionStatus

Type: object

Show Source

error(optional): object QueryJobError
links(optional): array link

A collection of links containing hrefs to query status and results
queryId(optional): integer(int64)
status(optional): string

{
    "type":"object",
    "properties":{
        "queryId":{
            "type":"integer",
            "format":"int64"
        },
        "status":{
            "type":"string"
        },
        "error":{
            "$ref":"#/definitions/QueryJobError"
        },
        "links":{
            "type":"array",
            "example":"{rel: 'status',href: '/patientapi/patients/queries/{id}'}",
            "xml":{
                "name":"link",
                "wrapped":true
            },
            "description":"A collection of links containing hrefs to query status and results",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : QueryJobError

Type: object

Show Source

errorCode(optional): string
errorMessage(optional): string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        }
    }
}

Nested Schema : link

Type: array

A collection of links containing hrefs to query status and results

Show Source

Array of: string

{
    "type":"array",
    "example":"{rel: 'status',href: '/patientapi/patients/queries/{id}'}",
    "xml":{
        "name":"link",
        "wrapped":true
    },
    "description":"A collection of links containing hrefs to query status and results",
    "items":{
        "type":"string"
    }
}

Example:

{rel: 'status',href: '/patientapi/patients/queries/{id}'}

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:7010/ohfapi/cg/v3.3/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": "/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries/1002"
      },
      {
        "rel": "result",
        "href": "/ohfapi/cg/v3.3/subjectapi/clinicalspecimens/queries/1002/data"
      }
    ]
  }
}