---
title: "List Lead Files"
method: GET
path: "/api/storage/leads/{lead_id}/files"
tags: ["storage"]
---

# List Lead Files

`GET /api/storage/leads/{lead_id}/files`

List all files and folders for a lead.

Args:
    lead_id: Lead UUID
    path: Subfolder path (optional, e.g., "applications", "quotes/2024")

Returns:
    FolderContents with files and folders

## Path parameters

- `lead_id` string, required

## Query parameters

- `path` string

## Response `200`

Successful Response

- FolderContents — Response model for folder contents
  - `folder_path` string, required
  - `files` FileInfo[], required
    - `name` string, required
    - `path` string, required
    - `size` integer, required
    - `type` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `mime_type` string, nullable
    - `download_url` string, nullable
  - `folders` string[], required
  - `total_files` integer, required
  - `total_folders` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/riskcube/apis/slack-lead-manager.md) · [All operations](https://skmtc.dev/riskcube/apis/slack-lead-manager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riskcube/slack-lead-manager/revisions/4442bbae8296/schema)