---
title: "Trigger C-FIND SCU"
method: POST
path: "/modalities/{id}/query"
tags: ["Networking"]
---

# Trigger C-FIND SCU

`POST /modalities/{id}/query`

Trigger C-FIND SCU command against the DICOM modality whose identifier is provided in URL: https://orthanc.uclouvain.be/book/users/rest.html#performing-query-retrieve-c-find-and-find-with-rest

## Path parameters

- `id` string, required

## Request body

- object
  - `Level` string — Level of the query (`Patient`, `Study`, `Series` or `Instance`)
  - `LocalAet` string — Local AET that is used for this commands, defaults to `DicomAet` configuration option or `LocalAet` in the `DicomModalities`.
  - `Normalize` boolean — Whether to normalize the query, i.e. whether to wipe out from the query, the DICOM tags that are not applicable for the query-retrieve level of interest
  - `Query` object — Associative array containing the filter on the values of the DICOM tags
  - `Timeout` number — DICOM SCU Timeout for this C-FIND command and subsequent C-GET/C-MOVE retrievals, in seconds (new in Orthanc 1.9.1). Orthanc will close the related DICOM associations if no DICOM messages are received within this time period.

## Response `200`

- object
  - `ID` string — Identifier of the query, to be used with `/queries/{id}`
  - `Path` string — Root path to the query in the REST API

---

[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/revisions/dbfb49bf0bc7/schema)
