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

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

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

## Request

- Base URL: `https://aiplatform.googleapis.com`
- URL: `https://aiplatform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:searchDataItems`
- 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`

Searches DataItems in a Dataset.

## Path parameters

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

## Query parameters

- `annotationFilters` string[]
- `annotationsFilter` string
- `annotationsLimit` integer
- `dataItemFilter` string
- `dataLabelingJob` string
- `fieldMask` string, google-fieldmask
- `orderBy` string
- `orderByAnnotation.orderBy` string
- `orderByAnnotation.savedQuery` string
- `orderByDataItem` string
- `pageSize` integer
- `pageToken` string
- `savedQuery` string

## Response `200`

Successful response

- GoogleCloudAiplatformV1SearchDataItemsResponse: Response message for DatasetService.SearchDataItems.
  - `dataItemViews` GoogleCloudAiplatformV1DataItemView[]: The DataItemViews read.
    - `annotations` GoogleCloudAiplatformV1Annotation[]: The Annotations on the DataItem. If too many Annotations should be returned for the DataItem, this field will be truncated per annotations_limit in request. If it was, then the has_truncated_annotations will be set to true.
      - `annotationSource` GoogleCloudAiplatformV1UserActionReference: References an API call. It contains more information about long running operation and Jobs that are triggered by the API call.
        - `dataLabelingJob` string: For API calls that start a LabelingJob. Resource name of the LabelingJob. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}`
        - `method` string: The method name of the API RPC call. For example, "/google.cloud.aiplatform.{apiVersion}.DatasetService.CreateDataset"
        - `operation` string: For API calls that return a long running operation. Resource name of the long running operation. Format: `projects/{project}/locations/{location}/operations/{operation}`
      - `createTime` string, google-datetime: Output only. Timestamp when this Annotation was created.
      - `etag` string: Optional. Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
      - `labels` object: Optional. The labels with user-defined metadata to organize your Annotations. 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 Annotation(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 Annotation: * "aiplatform.googleapis.com/annotation_set_name": optional, name of the UI's annotation set this Annotation belongs to. If not set, the Annotation is not visible in the UI. * "aiplatform.googleapis.com/payload_schema": output only, its value is the payload_schema's title.
      - `name` string: Output only. Resource name of the Annotation.
      - `payload` unknown
      - `payloadSchemaUri` string: Required. Google Cloud Storage URI points to a YAML file describing payload. The schema is defined as an [OpenAPI 3.0.2 Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/annotation/, note that the chosen schema must be consistent with the parent Dataset's metadata.
      - `updateTime` string, google-datetime: Output only. Timestamp when this Annotation was last updated.
    - `dataItem` GoogleCloudAiplatformV1DataItem: A piece of data in a Dataset. Could be an image, a video, a document or plain text.
      - `createTime` string, google-datetime: Output only. Timestamp when this DataItem was created.
      - `etag` string: Optional. Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
      - `labels` object: Optional. The labels with user-defined metadata to organize your DataItems. 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 DataItem(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.
      - `name` string: Output only. The resource name of the DataItem.
      - `payload` unknown
      - `satisfiesPzi` boolean: Output only. Reserved for future use.
      - `satisfiesPzs` boolean: Output only. Reserved for future use.
      - `updateTime` string, google-datetime: Output only. Timestamp when this DataItem was last updated.
    - `hasTruncatedAnnotations` boolean: True if and only if the Annotations field has been truncated. It happens if more Annotations for this DataItem met the request's annotation_filter than are allowed to be returned by annotations_limit. Note that if Annotations field is not being returned due to field mask, then this field will not be set to true no matter how many Annotations are there.
  - `nextPageToken` string: A token to retrieve next page of results. Pass to SearchDataItemsRequest.page_token to obtain that page.

## 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:searchDataItems/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)