---
title: "List Drive files"
method: GET
path: "/drive"
tags: ["Drive"]
---

# List Drive files

`GET /drive`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/drive`
- Auth: HTTP bearer

Lists the files and folders in the account's Faivelo Drive (folders first, then name-sorted), paginated. Omit `parentId` to list the root, or pass a folder id to list its contents. Read-only. Requires scope `drive:read`.

## Query parameters

- `parentId` string
- `offset` integer
- `limit` integer

## Response `200`

Drive file list

- object
  - `success` boolean
  - `data` DriveFileList: A page of Drive nodes plus the folder breadcrumb
    - `nodes` DriveNode[]
      - `id` string
      - `parentId` string, nullable: Parent folder id; null at the Drive root
      - `type` 'FILE' | 'FOLDER'
      - `name` string
      - `mimeType` string, nullable
      - `sizeBytes` integer: File size in bytes (0 for folders)
      - `trashedAt` string, date-time, nullable
      - `lastOpenedAt` string, date-time, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `breadcrumb` object[]: Root → current folder path (empty at the Drive root)
      - `id` string
      - `name` string
    - `hasMore` boolean: Whether more nodes exist past this page
    - `total` integer: Total node count in this folder
    - `offset` integer

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/faivelo/apis/faivelo-api.md) · [All operations](https://skmtc.dev/faivelo/apis/faivelo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faivelo/apis/faivelo-api/revisions/a7413ddea5d1?raw)