---
title: "Look for local resources"
method: POST
path: "/tools/find"
tags: ["System"]
---

# Look for local resources

`POST /tools/find`

This URI can be used to perform a search on the content of the local Orthanc server, in a way that is similar to querying remote DICOM modalities using C-FIND SCU: https://orthanc.uclouvain.be/book/users/rest.html#performing-finds-within-orthanc

## Request body

- object
  - `CaseSensitive` boolean — Enable case-sensitive search for PN value representations (defaults to configuration option `CaseSensitivePN`)
  - `Expand` boolean — If set to "true", retrieve detailed information about the individual resources, not only their Orthanc identifiers
  - `Full` boolean — If set to `true`, report the DICOM tags in full format (tags indexed by their hexadecimal format, associated with their symbolic name and their value)
  - `Labels` string[] — List of strings specifying which labels to look for in the resources (new in Orthanc 1.12.0)
  - `LabelsConstraint` string — Constraint on the labels, can be `All`, `Any`, or `None` (defaults to `All`, new in Orthanc 1.12.0). From 1.12.11: using `None` together with an empty list of labels looks for the resources that do not have any labels attached.
  - `Level` string — Level of the query (`Patient`, `Study`, `Series` or `Instance`)
  - `Limit` number — Limit the number of reported resources
  - `MetadataQuery` object — Associative array containing the filter on the values of the metadata (new in Orthanc 1.12.5)
  - `OrderBy` object[] — Array of associative arrays containing the requested ordering (new in Orthanc 1.12.5)
  - `ParentPatient` string — Limit the reported resources to descendants of this patient (new in Orthanc 1.12.5)
  - `ParentSeries` string — Limit the reported resources to descendants of this series (new in Orthanc 1.12.5)
  - `ParentStudy` string — Limit the reported resources to descendants of this study (new in Orthanc 1.12.5)
  - `Query` object — Associative array containing the filter on the values of the DICOM tags
  - `RequestedTags` string[] — A list of DICOM tags to include in the response (applicable only if "Expand" is set to true). 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.
  - `ResponseContent` string[] — Defines the content of response for each returned resource. (this field, if present, overrides the "Expand" field). 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`.(new in Orthanc 1.12.5)
  - `Short` boolean — If set to `true`, report the DICOM tags in hexadecimal format
  - `Since` number — Show only the resources since the provided index (in conjunction with `Limit`)

## Response `200`

- unknown

---

[API](https://skmtc.net/uclouvain/apis/orthanc-api.md) · [All operations](https://skmtc.net/uclouvain/apis/orthanc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uclouvain/orthanc-api/versions/9297c4930d96/schema)