Fetch Results (for qCT)

Learn how to fetch results for your uploaded DICOMs using the /results API.

Related Guides: For qCT

Overview

You can use the /results API to fetch the diagnostic results of the uploaded DICOM images. Append the SeriesInstanceUID in the request URL.

API Format

GET /results/<SeriesInstanceUID>

Request Formats

cURL

curl -X GET \\
-L 'Base_URL/results/<SeriesInstanceUID>' \\
-H 'Authorization: Token <PASTE_YOUR_TOKEN>' \\
-H 'Source: <PASTE_YOUR_SOURCE>' \\
-H 'User-Agent: <YOUR_USER_AGENT>'

Python

import requests
import pydicom

# To fetch SeriesInstanceUID using pydicom 

series_instance_uid = pydicom.read_file('<path/to/your/dicom_file.dcm>').SeriesInstanceUID

url = f"Base_URL/results/{series_instance_uid}"

# Headers, including the Authorization token and Source
headers = {
    'Authorization': 'Token <PASTE_YOUR_TOKEN>',
    'Source': '<PASTE_YOUR_SOURCE>',
    'User-Agent': '<YOUR_USER_AGENT>'
}

# Perform the GET request
response = requests.get(url, headers=headers)

# Print the response text
print(response.text)

Fetch Results(for qCT).

GETBASE_URL/results/{SeriesInstanceUID}

Path parameters

SeriesInstanceUID*string

The unique identifier for the series to fetch results for.

Response

200202400401403404409

Results fetched successfully

Body

application/json

successboolean

Example: true

messagestring

A message that validates the request based on the response status code.

Example: "Results retrieved successfully!"

triage_statusstring

Indicates the urgency of results.'Critical' for high priority needing immediate expert review, and 'Routine' for standard priority also requiring expert supervision.

Example: "critical"

resultobject

Contains the results for the uploaded DICOMs.

usecasestring

Describes the usecase.

Example: "qct"

Request

cURLPython

curl -X GET \\
-L 'Base_URL/results/<SeriesInstanceUID>' \\
-H 'Authorization: Token <PASTE_YOUR_TOKEN>' \\
-H 'Source: <PASTE_YOUR_SOURCE>'

Response

200202400401403404409

{
  "success": true,
  "message": "Results retrieved successfully!",
  "triage_status": "critical",
  "result": {
    "files": {
      "sc": [
        "<https://exampleurl.com>"
      ],
      "pdf": [
        "<https://exampleurl.com>"
      ],
      "sr": [
        "<https://exampleurl.com>"
      ],
      "sc_key_slices": [
        "<https://exampleurl.com>"
      ],
      "seg": [
        "<https://exampleurl.com>"
      ],
      "gsps": [
        "<https://exampleurl.com>"
      ],
      "json": [
        "<https://exampleurl.com>"
      ],
      "pr": [
        "<https://exampleurl.com>"
      ],
      "hl7": [
        "<https://exampleurl.com>"
      ],
      "encapsulated_pdf": [
        "<https://exampleurl.com>"
      ]
    }
  },
  "usecase": "qct"
}