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."],[[["\u003cp\u003e\u003ccode\u003eseries.searchForInstances\u003c/code\u003e retrieves a list of DICOM instances, as defined by the RetrieveTransaction in the DICOM standard.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL structure for \u003ccode\u003eseries.searchForInstances\u003c/code\u003e uses gRPC Transcoding syntax and requires the DICOM store's path in the \u003ccode\u003eparent\u003c/code\u003e parameter and a DICOMweb request path in the \u003ccode\u003edicomWebPath\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eTo call \u003ccode\u003eseries.searchForInstances\u003c/code\u003e, an empty request body must be sent through an HTTP GET request to the defined URL.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for accessing the DICOM store requires the \u003ccode\u003ehealthcare.dicomStores.dicomWebRead\u003c/code\u003e IAM permission on the specified \u003ccode\u003eparent\u003c/code\u003e resource, and either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-healthcare\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
