Stay organized with collections
Save and categorize content based on your preferences.
Full name: projects.locations.datasets.dicomStores.studies.series.searchForInstances
series.searchForInstances returns a list of matching instances. See RetrieveTransaction.
For details on the implementation of series.searchForInstances, see Search transaction in the Cloud Healthcare API conformance statement.
For samples that show how to call series.searchForInstances, see Search for DICOM data.
HTTP request
GET https://healthcare.googleapis.com/v1beta1/{parent=projects/*/locations/*/datasets/*/dicomStores/*}/dicomWeb/{dicomWebPath=studies/*/series/*/instances}
Required. The name of the DICOM store that is being accessed. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.
Authorization requires the following IAM permission on the specified resource parent:
healthcare.dicomStores.dicomWebRead
dicomWebPath
string
Required. The path of the SearchForInstancesRequest DICOMweb request. For example, instances, series/{seriesUid}/instances, or studies/{studyUid}/instances.
Request body
The request body must be empty.
Response body
If successful, the response is a generic HTTP response whose format is defined by the method.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["`series.searchForInstances` retrieves a list of DICOM instances, as defined by the RetrieveTransaction in the DICOM standard."],["The request URL structure for `series.searchForInstances` uses gRPC Transcoding syntax and requires the DICOM store's path in the `parent` parameter and a DICOMweb request path in the `dicomWebPath` parameter."],["To call `series.searchForInstances`, an empty request body must be sent through an HTTP GET request to the defined URL."],["Authorization for accessing the DICOM store requires the `healthcare.dicomStores.dicomWebRead` IAM permission on the specified `parent` resource, and either the `https://www.googleapis.com/auth/cloud-healthcare` or `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]
