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

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

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

## Request

- Base URL: `https://aiplatform.googleapis.com`
- URL: `https://aiplatform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/aiplatform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/aiplatform`
  - 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`

Gets a Dataset.

## Path parameters

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

## Query parameters

- `readMask` string, google-fieldmask

## Response `200`

Successful response

- GoogleCloudAiplatformV1Dataset: A collection of DataItems and Annotations on them.
  - `createTime` string, google-datetime: Output only. Timestamp when this Dataset was created.
  - `dataItemCount` string, int64: Output only. The number of DataItems in this Dataset. Only apply for non-structured Dataset.
  - `description` string: The description of the Dataset.
  - `displayName` string: Required. The user-defined name of the Dataset. The name can be up to 128 characters long and can consist of any UTF-8 characters.
  - `encryptionSpec` GoogleCloudAiplatformV1EncryptionSpec: Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource.
    - `kmsKeyName` string: Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
  - `etag` string: Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
  - `labels` object: The labels with user-defined metadata to organize your Datasets. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Dataset (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. Following system labels exist for each Dataset: * "aiplatform.googleapis.com/dataset_metadata_schema": output only, its value is the metadata_schema's title.
  - `metadata` unknown
  - `metadataArtifact` string: Output only. The resource name of the Artifact that was created in MetadataStore when creating the Dataset. The Artifact resource name pattern is `projects/{project}/locations/{location}/metadataStores/{metadata_store}/artifacts/{artifact}`.
  - `metadataSchemaUri` string: Required. Points to a YAML file stored on Google Cloud Storage describing additional information about the Dataset. The schema is defined as an OpenAPI 3.0.2 Schema Object. The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/metadata/.
  - `modelReference` string: Optional. Reference to the public base model last used by the dataset. Only set for prompt datasets.
  - `name` string: Output only. Identifier. The resource name of the Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`
  - `satisfiesPzi` boolean: Output only. Reserved for future use.
  - `satisfiesPzs` boolean: Output only. Reserved for future use.
  - `savedQueries` GoogleCloudAiplatformV1SavedQuery[]: All SavedQueries belong to the Dataset will be returned in List/Get Dataset response. The annotation_specs field will not be populated except for UI cases which will only use annotation_spec_count. In CreateDataset request, a SavedQuery is created together if this field is set, up to one SavedQuery can be set in CreateDatasetRequest. The SavedQuery should not contain any AnnotationSpec.
    - `annotationFilter` string: Output only. Filters on the Annotations in the dataset.
    - `annotationSpecCount` integer: Output only. Number of AnnotationSpecs in the context of the SavedQuery.
    - `createTime` string, google-datetime: Output only. Timestamp when this SavedQuery was created.
    - `displayName` string: Required. The user-defined name of the SavedQuery. The name can be up to 128 characters long and can consist of any UTF-8 characters.
    - `etag` string: Used to perform a consistent read-modify-write update. If not set, a blind "overwrite" update happens.
    - `metadata` unknown
    - `name` string: Output only. Resource name of the SavedQuery.
    - `problemType` string: Required. Problem type of the SavedQuery. Allowed values: * IMAGE_CLASSIFICATION_SINGLE_LABEL * IMAGE_CLASSIFICATION_MULTI_LABEL * IMAGE_BOUNDING_POLY * IMAGE_BOUNDING_BOX * TEXT_CLASSIFICATION_SINGLE_LABEL * TEXT_CLASSIFICATION_MULTI_LABEL * TEXT_EXTRACTION * TEXT_SENTIMENT * VIDEO_CLASSIFICATION * VIDEO_OBJECT_TRACKING
    - `supportAutomlTraining` boolean: Output only. If the Annotations belonging to the SavedQuery can be used for AutoML training.
    - `updateTime` string, google-datetime: Output only. Timestamp when SavedQuery was last updated.
  - `updateTime` string, google-datetime: Output only. Timestamp when this Dataset was last updated.

## Changes

- **2026-11-06** `3aca3b348f0c`: 4 info
  - the security scope `https://www.googleapis.com/auth/aiplatform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/aiplatform` 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`
- **2026-10-30** `34fcc627b062`: 4 info
  - the security scope `https://www.googleapis.com/auth/aiplatform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/aiplatform` 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/aiplatform/changes/v1/projects/:projectsId/locations/:locationsId/datasets/:datasetsId/get.md)

---

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