---
title: "Search folders"
method: GET
path: "/files/2026-09-beta/folders/search"
tags: ["Search"]
---

# Search folders

`GET /files/2026-09-beta/folders/search`

Search for folders in the HubSpot file manager using various query parameters to filter results. This endpoint allows you to retrieve folders based on specific criteria such as creation date, update date, folder name, and parent folder IDs. It supports pagination and sorting to help manage large sets of data efficiently.

## Query parameters

- `after` string
- `before` string
- `createdAt` string, date-time
- `createdAtGte` string, date-time
- `createdAtLte` string, date-time
- `idGte` integer
- `idLte` integer
- `ids` integer[]
- `limit` integer
- `name` string
- `parentFolderIds` integer[]
- `path` string
- `properties` string[]
- `sort` string[]
- `updatedAt` string, date-time
- `updatedAtGte` string, date-time
- `updatedAtLte` string, date-time

## Response `200`

successful operation

- CollectionResponseFolder
  - `paging` Paging
    - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required — A string token used to retrieve the next page of results.
      - `link` string — A string URL that provides the link to access the next page of results.
    - `prev` PreviousPage — specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required — A string token representing the cursor for the previous page of results.
      - `link` string — A string URL that provides a link to the previous page of results.
  - `results` Folder[], required — An array of folder objects, each representing a folder within the file manager.
    - `archived` boolean, required — A boolean indicating whether the folder is archived.
    - `archivedAt` string, date-time — The date and time when the folder was archived, in ISO 8601 format.
    - `createdAt` string, date-time, required — The date and time when the folder was created, in ISO 8601 format.
    - `id` string, required — The unique ID for the folder, represented as a string.
    - `name` string — The name of the folder, represented as a string.
    - `parentFolderId` string — The unique identifier of the parent folder, represented as a string.
    - `path` string — The path of the folder within the file system, represented as a string.
    - `updatedAt` string, date-time, required — The date and time when the folder was last updated, in ISO 8601 format.

## Other responses

- `default` — An error occurred.

---

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