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

# Search folders

`GET /files/2026-03/folders/search`

Search for folders. Does not contain hidden or archived folders.

## 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

- FilesCollectionResponseFolder
  - `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 paging cursor token for retrieving subsequent pages.
      - `link` string — A URL that can be used to retrieve the next page 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 used to identify the position before the current page in the pagination sequence.
      - `link` string — A URL string that provides a direct link to the previous page of results.
  - `results` FilesFolder[], required
    - `archived` boolean, required — Marks whether the folder is deleted or not.
    - `archivedAt` string, date-time — Timestamp of folder deletion.
    - `createdAt` string, date-time, required — Timestamp of folder creation.
    - `id` string, required — ID of the folder.
    - `name` string — Name of the folder.
    - `parentFolderId` string — ID of the parent folder.
    - `path` string — Path of the folder in the file manager.
    - `updatedAt` string, date-time, required — Timestamp of the latest update to the folder.

## Other responses

- `default` — An error occurred.

---

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