Method: fhir.Resource-incoming-references

Full name: projects.locations.datasets.fhirStores.fhir.Resource-incoming-references

Lists all the resources that directly refer to the given target FHIR resource. Can also support the case when the target resource doesn't exist, for example, if the target has been deleted.

On success, the response body contains a Bundle with type searchset, where each entry in the Bundle contains the full content of the resource. If the operation fails, an OperationOutcome is returned describing the failure. If the request cannot be mapped to a valid API method on a FHIR store, a generic Google Cloud error might be returned instead.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The name of the FHIR store that holds the target resource.

Authorization requires the following IAM permission on the specified resource parent:

  • healthcare.fhirStores.searchResources

Query parameters



Required. The target whose incoming references are requested. This param is required and must not be empty. It uses the format "ResourceType/ResourceID", for example, target=ResourceType/ResourceID.



Used to retrieve the next page of results when using pagination. Set _page_token to the value of _page_token set in next page links' url. Next page are returned in the response bundle's links field, where link.relation is "next".

Omit _page_token if no previous request has been made.



Maximum number of resources in a page. If not specified, 100 is used. May not be larger than 1000.



Used to simplify the representation of the returned resources. _summary=text returns only the text, id, and meta top-level fields. _summary=data removes the text field and returns all other fields. _summary=false returns all parts of the resource(s). Either not providing this parameter or providing an empty value to this parameter also returns all parts of the resource(s).



String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) are returned. If not provided or an empty value is provided, no filter on the returned resource type(s) is applied.

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.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.