---
title: "List files"
method: GET
path: "/api/v1/files"
tags: ["Files"]
---

# List files

`GET /api/v1/files`

## Query parameters

- `page` integer
- `limit` integer
- `status` 'pending' | 'confirmed' | 'expired'

## Response `200`

Paginated file list

- SuccessResponseFileList
  - `ok` true
  - `data` object
    - `files` FileDetail[]
      - `fileId` string, uuid
      - `filename` string
      - `contentType` string
      - `bytes` integer, nullable
      - `sha256` string, nullable
      - `status` 'pending' | 'confirmed' | 'expired'
      - `createdAt` string, date-time
      - `confirmedAt` string, date-time, nullable
      - `downloadUrl` string, uri
    - `page` integer
    - `limit` integer
    - `total` integer

## Changes

- **2026-04-17** `5eb4ed0f33c7` — 18 breaking, 4 warning, 4 info
  - the response property `data/files/items/bytes` became nullable for the status `200`
  - the response property `data/files/items/confirmedAt` became nullable for the status `200`
  - the response property `data/files/items/sha256` became nullable for the status `200`
  - the response property `data` became optional for the status `200`
  - …22 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/files/get.md)

---

[API](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api.md) · [All operations](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbybit-dev/bitbybit-cad-cloud-api/revisions/5eb4ed0f33c7/schema)