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

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

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

## Request

- Base URL: `https://healthcare.googleapis.com`
- URL: `https://healthcare.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/datasets`
- 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/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the health datasets in the current project.

## Path parameters

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

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListDatasetsResponse: Lists the available datasets.
  - `datasets` Dataset[]: The first page of datasets.
    - `encryptionSpec` EncryptionSpec: Represents a customer-managed encryption key spec that can be applied to a resource.
      - `kmsKeyName` string: Required. The resource name of customer-managed encryption key that is used to secure a resource and its sub-resources. Only the key in the same location as this Dataset is allowed to be used for encryption. Format is: `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{key}`
    - `name` string: Identifier. Resource name of the dataset, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`.
    - `satisfiesPzi` boolean: Output only. Whether the dataset satisfies zone isolation.
    - `satisfiesPzs` boolean: Output only. Whether the dataset satisfies zone separation.
    - `timeZone` string: Optional. The default timezone used by this dataset. Must be a either a valid IANA time zone name such as "America/New_York" or empty, which defaults to UTC. This is used for parsing times in resources, such as HL7 messages, where no explicit timezone is specified.
  - `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/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)
