v1

latestOpenAPI 3.0.02026-07-132990743.4 KB
Patients

List the available patients

List the Orthanc identifiers of all the available DICOM patients

get/patients

Query parameters

expandstring

If present, retrieve detailed information about the individual resources, not only their Orthanc identifiers

fullboolean

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

limitnumber

Limit the number of results

requested-tagsstring

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: 'requested-tags=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 all Main Dicom Tags to keep backward compatibility with Orthanc prior to 1.11.0.

response-contentstring

Defines the content of response for each returned resource. Allowed values are MainDicomTags, Metadata, Children, Parent, Labels, Status, IsStable, IsProtected, Attachments. If not specified, Orthanc will return MainDicomTags, Metadata, Children, Parent, Labels, Status, IsStable, IsProtected.e.g: 'response-content=MainDicomTags;Children (new in Orthanc 1.12.5 - overrides expand)

shortboolean

If present, report the DICOM tags in hexadecimal format

sincenumber

Show only the resources since the provided index

Response

{"stackTrail":"paths:/patients:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown","description":"JSON array containing either the Orthanc identifiers, or detailed information about the reported patients (if `expand` argument is provided)","example":["0946fcb6-cf12ab43-bad958c1-bf057ad5-0fc6f54c","16738bc3-e47ed42a-43ce044c-a3414a45-cb069bd0"]}

Example response

[
  "0946fcb6-cf12ab43-bad958c1-bf057ad5-0fc6f54c",
  "16738bc3-e47ed42a-43ce044c-a3414a45-cb069bd0"
]