Inobitec DICOM Server (DICOM Web Services) (2.9)

Download OpenAPI specification:Download

Technical support and integration: support@inobitec.com URL: https://inobitec.com/eng/about/contacts/

WADO-URI, WADO-RS, QIDO-RS, STOW-RS and UPS-RS RESTful services implementation

WADO-URI Instances Resources

Retrieve representations of Instances

The URI Service, also known as WADO-URI, enables a user agent to retrieve representations of Instances using HTTP. The URI Service has two transactions:

  • Retrieve DICOM Instance: this transaction retrieves a single Instance in the application/dicom media type.
  • Retrieve Rendered Instance: this transaction retrieves a single Instance in a Rendered Media Type.

These two transactions have the same "requestType" type but are differentiated by their Selected Media Type. If there is no "contentType" Query Parameter and the Accept header field is */*, then the Selected Media Type defaults to image/jpeg media type and the transaction defaults to Retrieve Rendered Instance.

query Parameters
requestType
required
string
Example: requestType=WADO

This parameter specifies that this is a URI service request. The parameter name shall be "requestType", and the value shall be "WADO". If the value is other than "WADO", and the origin server does not support the value, the response shall be 400 (Bad Request), and may include a payload containing an appropriate error message.

studyUID
required
string <Unique Identifier (UI)>

The value of this parameter is a Study Instance UID.

seriesUID
required
string <Unique Identifier (UI)>

The value of this parameter is a Series Instance UID.

objectUID
required
string <Unique Identifier (UI)>

The value of this parameter is a SOP Instance UID.

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

character-set
string <character-set>

The Character Set Query Parameter value is a comma-separated list of one or more character set identifiers. See PS3.18 8.3.3.2

frameNumber
integer >= 1

This parameter specifies a single frame within a multi-frame image Instance, as defined in PS3.3 that shall be returned. Its name is "frameNumber" and its value shall be a positive integer (i.e., starts at 1 not 0). This parameter applyed only to Retrieve Rendered Instance transaction.

annotation
stringpatient|technique

This parameter specifies that the rendered images or video will have annotations. See PS3.18 8.3.2.1.1. This parameter applyed only to Retrieve Rendered Instance transaction.

quality
integer [ 1 .. 100 ]

The "quality" parameter specifies the requested quality of the rendered images or video. The "quality" parameter is only supported for media types that allow lossy compression. See PS3.13 8.3.5.1.2. This parameter applyed only to Retrieve Rendered Instance transaction.

rows
integer <int64> >= 1

This parameter specifies the height, in pixels, of the returned image. If this parameter present, the "columns" parameter shall be present. This parameter applyed only to Retrieve Rendered Instance transaction.

columns
integer <int64> >= 1

This parameter specifies the width, in pixels, of the returned image. If this parameter present, the "rows" parameter shall be present. This parameter applyed only to Retrieve Rendered Instance transaction.

region
Array of numbers <float> = 4 items [ items <float > ]
Example: region=0.1,0.1,0.9,0.8

This parameter specifies a rectangular region of the Target resource. Its values shall be a comma-separated list of four positive decimal numbers:

  • xmin: the left column of the region;
  • ymin: the top row of the region;
  • xmax: the right column of the region;
  • ymax: the bottom row of the region.

The region is specified using a normalized coordinate system relative to the size of the original image matrix, measured in rows and columns, where:

  • 0.0, 0.0 corresponds to the top row and left column of the image;
  • 1.0, 1.0 corresponds to the bottom row and right column of the image;
  • 0.0 <= xmin < xmax <= 1.0;
  • 0.0 <= ymin < ymax <= 1.0.

This parameter when used in conjunction with "row" and "columns" parameters, allows the user agent to map a selected area of the source image into its viewport. This parameter applyed only to Retrieve Rendered Instance transaction.

windowCenter
number <DS (Decimal String)>

This parameter specifies the Window Center of the returned image as defined in PS3.3. The Windowing parameters (Window Center and Window Width) are optional; however, if either is present, both shall be present. This parameter applyed only to Retrieve Rendered Instance transaction.

windowWidth
number <DS (Decimal String)>

This parameter specifies the Window Width of the returned image as defined in PS3.3. The Windowing parameters (Window Center and Window Width) are optional; however, if either is present, both shall be present. This parameter applyed only to Retrieve Rendered Instance transaction.

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
text/plain
Example
One or more required parameters are missed

QIDO-RS Study Resources

Find all Studies

Searches the entire service for Studies that match the search parameters, and returns a list of matching Studies, including the default and requested Attributes that are supported for each Study.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

StudyInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000D
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

QIDO-RS Series Resources

Find Study's Series

Searches for all Series in the specified Study that match the search parameters, and returns a list of matching Series, including the default and requested Attributes that are supported for each Series.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

SeriesInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000E
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

Find all Series

Searches the entire service for Series that match the search parameters, and returns a list of matching Series, including the default and requested Attributes that are supported for each Series.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

StudyInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000D
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

SeriesInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000E
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

QIDO-RS Instances Resources

Find Study Series' Instances

Searches for all Instances in the specified Study and Series that match the search parameters, and returns a list of matching Instances, including the default and requested Attributes that are supported for each Series

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

query Parameters
InstanceNumber
string <Integer String (IS)>

A pair of Attribute/Value specify the matching criteria for the search.

SOPClassUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

SOPInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

Find Study's Instances

Searches for all Instances in the specified Study that match the search parameters, and returns a list of matching Instances, including the default and requested Attributes that are supported for each Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

SeriesInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000E
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

InstanceNumber
string <Integer String (IS)>

A pair of Attribute/Value specify the matching criteria for the search.

SOPClassUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

SOPInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

Find all Instances

Searches the entire service for Instances that match the search parameters, and returns a list of matching Instances, including the default and requested Attributes that are supported for each Series.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

StudyInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000D
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

SeriesInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

0020000E
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

InstanceNumber
string <Integer String (IS)>

A pair of Attribute/Value specify the matching criteria for the search.

00200013
string <Integer String (IS)>

A pair of Attribute/Value specify the matching criteria for the search.

SOPClassUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

00080016
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

SOPInstanceUID
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

00080018
Array of strings <Unique Identifier (UI)>

A comma-separated list of UIDs.

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
[
  • {
    }
]

STOW-RS Resources

Store Instances

Stores a set of representations that may have different Study Instance UIDs.

header Parameters
Content-Type
string <media-type>

The DICOM Media Type of the request payload.

Content-Length
integer <int64> >= 0

Shall be present if a content encoding has not been applied to the payload

Content-Encoding
string <encoding>

Shall be present if a content encoding has been applied to the payload

Request Body schema: application/dicom
string <binary>

Responses

Response samples

Content type
"string"

Store Study Instances

Stores a set of representations that belong to the same Study, i.e., each representation shall have the same Study Instance UID.

path Parameters
study
required
string <Unique Identifier (UI)>

Study UID

header Parameters
Content-Type
string <media-type>

The DICOM Media Type of the request payload.

Content-Length
integer <int64> >= 0

Shall be present if a content encoding has not been applied to the payload

Content-Encoding
string <encoding>

Shall be present if a content encoding has been applied to the payload

Request Body schema: application/dicom
string <binary>

Responses

Response samples

Content type
"string"

WADO-RS Instances Resources

Get all DICOM objects of the study

The Study resource references a single Study.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get all DICOM objects in a series

The Series resource references a single Series.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get a DICOM object

The Instance resource references a single Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

WADO-RS Metadata Resources

Get metadata of all DICOM objects of the study

The Study Metadata resource references the Metadata of a Study.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

character-set
string <character-set>

The Character Set Query Parameter value is a comma-separated list of one or more character set identifiers. See PS3.18 8.3.3.2

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
"string"

Get metadata for all DICOM objects in a series in a study

The Series Metadata resource contains the Metadata of a Series in a Study.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

character-set
string <character-set>

The Character Set Query Parameter value is a comma-separated list of one or more character set identifiers. See PS3.18 8.3.3.2

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
"string"

Get metadata for all DICOM objects in a series in a study

The Instance Metadata resource contains the Metadata of an Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
character-set
string <character-set>

The Character Set Query Parameter value is a comma-separated list of one or more character set identifiers. See PS3.18 8.3.3.2

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
"string"

WADO-RS Rendered Resources

Get a render of the study

The Rendered Study resource references a Study to be rendered.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
annotation
stringpatient|technique

This parameter specifies that the rendered images or video will have annotations. See PS3.18 8.3.2.1.1

quality
integer [ 1 .. 100 ]

The "quality" parameter specifies the requested quality of the rendered images or video. The "quality" parameter is only supported for media types that allow lossy compression. See PS3.13 8.3.5.1.2

viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

window
string^\d+,\d+,(linear|linear-exact|sigmoid)$

Controls the windowing of the images or video. See PS 8.13 8.3.5.1.4

iccprofile
string^(no|yes|srgb|adobergb|rommrgb)$

Specifies the color characteristics of, and inclusion of an ICC Profile in, the rendered images. See PS3.18 8.3.5.1.5

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get a series render

The Rendered Series resource references a Series to be rendered.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

query Parameters
annotation
stringpatient|technique

This parameter specifies that the rendered images or video will have annotations. See PS3.18 8.3.2.1.1

quality
integer [ 1 .. 100 ]

The "quality" parameter specifies the requested quality of the rendered images or video. The "quality" parameter is only supported for media types that allow lossy compression. See PS3.13 8.3.5.1.2

viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

window
string^\d+,\d+,(linear|linear-exact|sigmoid)$

Controls the windowing of the images or video. See PS 8.13 8.3.5.1.4

iccprofile
string^(no|yes|srgb|adobergb|rommrgb)$

Specifies the color characteristics of, and inclusion of an ICC Profile in, the rendered images. See PS3.18 8.3.5.1.5

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get a render of a DICOM object

The Rendered Instance resource references an Instance to be rendered.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
annotation
stringpatient|technique

This parameter specifies that the rendered images or video will have annotations. See PS3.18 8.3.2.1.1

quality
integer [ 1 .. 100 ]

The "quality" parameter specifies the requested quality of the rendered images or video. The "quality" parameter is only supported for media types that allow lossy compression. See PS3.13 8.3.5.1.2

viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

window
string^\d+,\d+,(linear|linear-exact|sigmoid)$

Controls the windowing of the images or video. See PS 8.13 8.3.5.1.4

iccprofile
string^(no|yes|srgb|adobergb|rommrgb)$

Specifies the color characteristics of, and inclusion of an ICC Profile in, the rendered images. See PS3.18 8.3.5.1.5

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get frame render

The Rendered Frames resource references an ordered collection of frames of a single multi-frame Instance, to be rendered.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

frames
required
Array of integers <int32> [ items <int32 > ]

A comma-separated list of frame numbers, in ascending order, contained within an Instance.

query Parameters
annotation
stringpatient|technique

This parameter specifies that the rendered images or video will have annotations. See PS3.18 8.3.2.1.1

quality
integer [ 1 .. 100 ]

The "quality" parameter specifies the requested quality of the rendered images or video. The "quality" parameter is only supported for media types that allow lossy compression. See PS3.13 8.3.5.1.2

viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

window
string^\d+,\d+,(linear|linear-exact|sigmoid)$

Controls the windowing of the images or video. See PS 8.13 8.3.5.1.4

iccprofile
string^(no|yes|srgb|adobergb|rommrgb)$

Specifies the color characteristics of, and inclusion of an ICC Profile in, the rendered images. See PS3.18 8.3.5.1.5

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

WADO-RS Thumbnail Resources

Get a study thumbnail

The Study Thumbnail resource references a thumbnail image of a Study.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get a series thumbnail

The Series Thumbnail resource references a thumbnail image of a Series.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

query Parameters
viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get a thumbnail of a DICOM object

The Instance Thumbnail resource references a thumbnail image of an Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get the frame thumbnail

The Frame Thumbnail resource references a thumbnail image for frames within an Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

frames
required
Array of integers <int32> [ items <int32 > ]

A comma-separated list of frame numbers, in ascending order, contained within an Instance.

query Parameters
viewport
string^\d+,\d+(,\d*,\d*,\d*,\d*)?$

Specifies a rectangular region of the source image(s) or video to be cropped, and a rectangular region corresponding to the size of the user agent's viewport to which the cropped image or video should be scaled. See PS3.18 8.3.2.1.3

accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

WADO-RS Bulkdata Resources

Get the raw data of a DICOM object

The Instance Bulkdata resource references the Bulkdata of a Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

WADO-RS Pixel Data Resources

Get the pixel data of a DICOM object

The Instance Pixel Data resource references the Pixel Data of a Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Get pixel data of frames

The Frames resource references an ordered collection of frames in a single multi-frame Instance.

path Parameters
study
required
string <Unique Identifier (UI)>

The Study Instance UID of a Study managed by the Studies Service.

series
required
string <Unique Identifier (UI)>

The Series Instance UID of a Series contained within a Study resource.

instance
required
string <Unique Identifier (UI)>

The SOP Instance UID of an Instance contained within a Series resource.

frames
required
Array of integers <int32> [ items <int32 > ]

A comma-separated list of frame numbers, in ascending order, contained within an Instance.

query Parameters
accept
string <media-type>

The Accept Query Parameter has the same syntax as the Accept header field, except that it shall not have wildcards (<type>/* or */*). See PS3.18 8.3.3.1

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

UPS-RS Worklist Resources

Create Worklist

Create Unified Procedure Worklist.

query Parameters
AffectedSOPInstanceUID
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

00001000
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

SOPInstanceUID
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

00080018
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

header Parameters
Content-Type
string <media-type>

The DICOM Media Type of the request payload.

Content-Length
integer <int64> >= 0

Shall be present if a content encoding has not been applied to the payload

Content-Encoding
string <encoding>

Shall be present if a content encoding has been applied to the payload

Request Body schema: application/dicom
string <binary>

Responses

Find all Worklists

Searches the entire service for Worklist that match the search parameters, and returns a list of matching Worklists, including the default and requested Attributes that are supported for each UPS.

query Parameters
object

One or more DICOM Attribute/Values pairs specify the matching criteria for the search. See PS3.18 8.3.4.1

fuzzymatching
boolean
Default: false

A single parameter specifies whether Fuzzy Matching of Person Names is to be performed. See PS3.18 8.3.4.2

includefield
string <^(all|\w(,\w)+)$>

A parameter specifies the Attributes that should be included in the response. See PS3.18 8.3.4.3

limit
integer <int64> >= 0

A single parameter specifies the maximum number of matches the origin server shall return in a single response. See PS3.18 8.3.4.4

offset
integer <int64> >= 0
Default: 0

A single parameter specifies the number of matches the origin server shall skip before the first returned match. See PS3.18 8.3.4.4

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
No sample

Update Worklist

Update Unified Procedure Worklist.

path Parameters
workitem
required
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

query Parameters
TransactionUID
string <Unique Identifier (UI)>

the Transaction UID of a Workitem.

00081195
string <Unique Identifier (UI)>

the Transaction UID of a Workitem.

header Parameters
Content-Type
string <media-type>

The DICOM Media Type of the request payload.

Content-Length
integer <int64> >= 0

Shall be present if a content encoding has not been applied to the payload

Content-Encoding
string <encoding>

Shall be present if a content encoding has been applied to the payload

Request Body schema: application/dicom
string <binary>

Responses

Retieve Worklist

Search for worklist with specified UID.

path Parameters
workitem
required
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

header Parameters
Accept
string <media-type>

The Acceptable Media Types for the response payload. See PS3.18 8.4.1.1

Accept-Charset
string <charset>

The Acceptable Character Sets of the response payload. See PS3.18 8.8

Responses

Response samples

Content type
No sample

Change Worklist State

Changing Unified Procedure Worklist State.

path Parameters
workitem
required
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

header Parameters
Content-Type
string <media-type>

The DICOM Media Type of the request payload.

Content-Length
integer <int64> >= 0

Shall be present if a content encoding has not been applied to the payload

Content-Encoding
string <encoding>

Shall be present if a content encoding has been applied to the payload

Request Body schema: application/dicom
string <binary>

Responses

Cancel Worklist

Cancel Unified Procedure Worklist.

path Parameters
workitem
required
string <Unique Identifier (UI)>

the SOP Instance UID of a Workitem.

Responses