Stay organized with collections
Save and categorize content based on your preferences.
Full name: projects.locations.datasets.dicomStores.studies.series.instances.retrieveRendered
instances.retrieveRendered returns instance associated with the given study, series, and SOP Instance UID in an acceptable Rendered Media Type. See RetrieveTransaction.
For details on the implementation of instances.retrieveRendered, see Rendered resources in the Cloud Healthcare API conformance statement.
GET https://healthcare.googleapis.com/v1/{parent=projects/*/locations/*/datasets/*/dicomStores/*}/dicomWeb/{dicomWebPath=studies/*/series/*/instances/*/rendered}
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 instances.retrieveRendered DICOMweb request. For example, studies/{studyUid}/series/{seriesUid}/instances/{instanceUid}/rendered.
[[["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\u003einstances.retrieveRendered\u003c/code\u003e retrieves a specific DICOM instance based on its study, series, and SOP Instance UID, returning it in an acceptable Rendered Media Type as defined by the DICOMweb standard.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003eGET\u003c/code\u003e method and requires the \u003ccode\u003eparent\u003c/code\u003e path parameter, which specifies the DICOM store, and the \u003ccode\u003edicomWebPath\u003c/code\u003e parameter to define the location of the instance with the study, series, and instance UID, and the format follows gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eviewport\u003c/code\u003e query parameter can be included to specify the viewport setting, as detailed in the DICOM standard.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the authorization for this endpoint requires 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,["# Method: instances.retrieveRendered\n\n**Full name**: projects.locations.datasets.dicomStores.studies.series.instances.retrieveRendered\n\ninstances.retrieveRendered returns instance associated with the given study, series, and SOP Instance UID in an acceptable Rendered Media Type. See [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4).\n\nFor details on the implementation of instances.retrieveRendered, see [Rendered resources](https://cloud.google.com/healthcare/docs/dicom#rendered_resources) in the Cloud Healthcare API conformance statement.\n\nFor samples that show how to call instances.retrieveRendered, see [Retrieve consumer image formats](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieve-consumer).\n\n### HTTP request\n\n`GET https://healthcare.googleapis.com/v1/{parent=projects/*/locations/*/datasets/*/dicomStores/*}/dicomWeb/{dicomWebPath=studies/*/series/*/instances/*/rendered}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-healthcare`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
