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

# Search Files

`GET /api/v1/files/search`

Search files and folders by name across the whole company.

Case-insensitive substring match on ``name``. Results are gated by the same
per-resource VIEWER ACL the list endpoints use (owners see everything).
Empty ``q`` returns empty results without touching the database — the guard
runs before the permission-graph lookups so an empty query is truly free.

## Query parameters

- `q` string
- `limit` integer

## Response `200`

Successful Response

- FileSearchResponse — Company-wide file/folder name-search results.
  - `folders` FileFolderSearchResult[]
    - `id` string, required
    - `name` string, required
    - `parent_folder_id` string, nullable
    - `merge_enabled` boolean, required
    - `schema_mode` string, required
    - `merge_database_id` string, nullable
    - `parent_path` string
  - `files` UserFileSearchResult[]
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `user_id` string, uuid, required
    - `folder_id` string, uuid, nullable
    - `name` string, required
    - `file_type` string, required
    - `size_bytes` integer, required
    - `meta` object, required
    - `created_at` string, date-time, required
    - `parse_state` string, required
    - `folder_path` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/revisions/a59877bf911b/schema)