---
title: "List files"
method: GET
path: "/file-storage/files"
tags: ["File Storage"]
---

# List files

`GET /file-storage/files`

## Request

- Base URL: `https://unify.apideck.com`
- URL: `https://unify.apideck.com/file-storage/files`
- Auth: API key in header `Authorization`

Returns a paginated list of files from the connected file storage platform.

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string

## Response `200`

Files returned

- FilesResponse
  - `status_code` integer
  - `status` string
  - `data` File[]
    - `id` string
    - `name` string
    - `size` integer
    - `mime_type` string
    - `parent_folder_id` string
    - `updated_at` string, date-time
  - `meta` Meta: Cursor-based pagination metadata.
    - `items_on_page` integer
    - `cursors` object
      - `previous` string, nullable
      - `current` string, nullable
      - `next` string, nullable

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid API key.
- `404`: The requested resource, connection, or connector could not be found.

---

[API](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/revisions/1814558af2d7?raw)