v1

latestOpenAPI 3.0.02026-07-142740323.4 KB

Instances

Get information about some instance

Get detailed information about the DICOM instance whose Orthanc identifier is provided in the URL

get/instances/{id}

Path parameters

idstring required

Orthanc identifier of the instance of interest

Query parameters

fullboolean

If present, report the DICOM tags in full format (tags indexed by their hexadecimal format, associated with their symbolic name and their value)

requestedTagsstring

If present, list the DICOM Tags you want to list in the response. This argument is a semi-column separated list of DICOM Tags identifiers; e.g: 'requestedTags=0010,0010;PatientBirthDate'. The tags requested tags are returned in the 'RequestedTags' field in the response. Note that, if you are requesting tags that are not listed in the Main Dicom Tags stored in DB, building the response might be slow since Orthanc will need to access the DICOM files. If not specified, Orthanc will return

shortboolean

If present, report the DICOM tags in hexadecimal format

Response

{"stackTrail":"paths:/instances/{id}:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown","description":"Information about the DICOM instance","example":{"FileSize":526744,"FileUuid":"dc031d9e-ef02-4871-821f-ffe445deb7c2","ID":"d94d9a03-3003b047-a4affc69-322313b2-680530a2","IndexInSeries":155,"MainDicomTags":{"AcquisitionNumber":"4","ImageOrientationPatient":"1\\0\\0\\0\\1\\0","ImagePositionPatient":"-249.51171875\\-458.51171875\\314","InstanceCreationDate":"20151217","InstanceCreationTime":"125204.215000","InstanceNumber":"155","SOPInstanceUID":"1.3.6.1.4.1.14519.5.2.1.2193.7172.168997935789297163075628247666"},"ParentSeries":"52f4cb90-29d1d1a2-2ca34edd-4b8851fc-8cb269f2","Type":"Instance"}}

Example response

{
  "FileSize": 526744,
  "FileUuid": "dc031d9e-ef02-4871-821f-ffe445deb7c2",
  "ID": "d94d9a03-3003b047-a4affc69-322313b2-680530a2",
  "IndexInSeries": 155,
  "MainDicomTags": {
    "AcquisitionNumber": "4",
    "ImageOrientationPatient": "1\\0\\0\\0\\1\\0",
    "ImagePositionPatient": "-249.51171875\\-458.51171875\\314",
    "InstanceCreationDate": "20151217",
    "InstanceCreationTime": "125204.215000",
    "InstanceNumber": "155",
    "SOPInstanceUID": "1.3.6.1.4.1.14519.5.2.1.2193.7172.168997935789297163075628247666"
  },
  "ParentSeries": "52f4cb90-29d1d1a2-2ca34edd-4b8851fc-8cb269f2",
  "Type": "Instance"
}