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

# GET /v1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/files

`GET /v1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/files`

## Request

- Base URL: `https://aiplatform.googleapis.com`
- URL: `https://aiplatform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/files`
- Auth: 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`

Lists the files owned by the requesting project and location. Supports two mutually exclusive modes: paginated listing via an opaque `page` cursor, or batch fetch by `ids`. See `ListFilesRequest`.

## Path parameters

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

## Query parameters

- `limit` integer
- `page` string

## Response `200`

Successful response

- GoogleCloudAiplatformV1ListFilesResponse: Response message for ClaudeFileService.ListFiles.
  - `data` GoogleCloudAiplatformV1ClaudeFile[]: The files.
    - `created_at` string, google-datetime: Output only. The time at which the file was created.
    - `downloadable` boolean: Output only. Whether the contents of this file can be retrieved with `DownloadFile`. False for user-uploaded files, true for tool-generated ones.
    - `expires_at` string, google-datetime: Output only. The time at which the file expires and is deleted, set from the `expires_in_seconds` upload form field. Unset for files that do not expire, which is serialised as `null`.
    - `filename` string: Output only. The original name of the uploaded file, taken from the `Content-Disposition` header on upload. Between 1 and 255 characters. Control characters and the characters `<>:"|?*\/` are not accepted.
    - `id` string: Output only. The server-assigned identifier of the file, for example `file_abc123`. This is the ID to pass in subsequent model requests.
    - `mime_type` string: Output only. The media type of the file, taken from the `Content-Type` header of the file part on upload.
    - `size_bytes` integer: Output only. The size of the file in bytes.
    - `type` string: Output only. The object type. Always `file`.
  - `next_page` string: Opaque cursor for the next page. Unset on the last page, and always unset when `ids` was supplied, since batch fetch is single-page.

## Changes

- **2026-11-06** `3aca3b348f0c`: 1 warning
  - deleted the `query` request parameter `ids`

[Operation history](https://skmtc.dev/google/apis/aiplatform/changes/v1/projects/:projectsId/locations/:locationsId/publishers/:publishersId/files/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)