---
title: "GET /v3/folders:search"
method: GET
path: "/v3/folders:search"
tags: ["folders"]
---

# GET /v3/folders:search

`GET /v3/folders:search`

Search for folders that match specific filter criteria. `search()` provides an eventually consistent view of the folders a user has access to which meet the specified filter criteria. This will only return folders on which the caller has the permission `resourcemanager.folders.get`.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `query` string

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudresourcemanager.md) · [All operations](https://skmtc.dev/google/apis/cloudresourcemanager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudresourcemanager/revisions/3d76e8caf96a/schema)