---
title: "List files (Gemini format)"
method: GET
path: "/genai/v1beta/files"
tags: ["GenAI Integration"]
---

# List files (Gemini format)

`GET /genai/v1beta/files`

Lists uploaded files in Google Gemini API format.

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- object
  - `files` object[]
    - `name` string — File resource name (e.g., files/abc123)
    - `displayName` string
    - `mimeType` string
    - `sizeBytes` string — Size in bytes (returned as string by Gemini API)
    - `createTime` string, date-time
    - `updateTime` string, date-time
    - `expirationTime` string, date-time
    - `sha256Hash` string
    - `uri` string — URI for accessing the file content
    - `state` 'STATE_UNSPECIFIED' | 'PROCESSING' | 'ACTIVE' | 'FAILED'
    - `error` object
      - `code` integer
      - `message` string
    - `videoMetadata` object
      - `videoDuration` string
  - `nextPageToken` string

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)