---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/consentStores"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/consentStores"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/consentStores

`GET /v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/consentStores`

## Request

- Base URL: `https://healthcare.googleapis.com`
- URL: `https://healthcare.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/consentStores`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-healthcare`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-healthcare`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
- TypeScript: <https://skmtc.dev/google/apis/healthcare/docs/v1/projects/:projectsId/locations/:locationsId/datasets/:datasetsId/consentStores/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the consent stores in the specified dataset.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `datasetsId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListConsentStoresResponse
  - `consentStores` ConsentStore[]: The returned consent stores. The maximum number of stores returned is determined by the value of page_size in the ListConsentStoresRequest.
    - `defaultConsentTtl` string, google-duration: Optional. Default time to live for Consents created in this store. Must be at least 24 hours. Updating this field will not affect the expiration time of existing consents.
    - `enableConsentCreateOnUpdate` boolean: Optional. If `true`, UpdateConsent creates the Consent if it does not already exist. If unspecified, defaults to `false`.
    - `labels` object: Optional. User-supplied key-value pairs used to organize consent stores. Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}. Label values must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}. No more than 64 labels can be associated with a given store. For more information: https://cloud.google.com/healthcare/docs/how-tos/labeling-resources
    - `name` string: Identifier. Resource name of the consent store, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/consentStores/{consent_store_id}`. Cannot be changed after creation.
  - `nextPageToken` string: Token to retrieve the next page of results, or empty if there are no more results in the list.

## Changes

- **2026-10-30** `7027c0ced7f9`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-healthcare` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-healthcare` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/healthcare/changes/v1/projects/:projectsId/locations/:locationsId/datasets/:datasetsId/consentStores/get.md)

---

[API](https://skmtc.dev/google/apis/healthcare.md) - [All operations](https://skmtc.dev/google/apis/healthcare/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/healthcare/revisions/7027c0ced7f9?raw)