---
title: "Get top-level folders in a team"
method: GET
path: "/v2/teams/{team_id}/folders"
tags: ["Folders"]
---

# Get top-level folders in a team

`GET /v2/teams/{team_id}/folders`

Get a list of the top-level folders (previously called "projects") within the specified team. Subfolders can be traversed with the GET /v2/folders/{folder_id}/folders endpoint. It is not possible to programmatically obtain team IDs. To obtain a team ID, navigate to the team page in the Figma file browser. The team ID is present in the URL after the word team. For example, in `https://www.figma.com/files/181033233908053158/team/1535685101263221741`, the team ID is `1535685101263221741`.

## Path parameters

- `team_id` string, required

## Response `200`

Response from the GET /v2/teams/{team_id}/folders endpoint.

- object
  - `name` string, required — The team's name.
  - `folders` Folder[], required — An array of the team's top-level folders. Each folder's `parent_folder_id` is null.
    - `id` string, required — The ID of the folder.
    - `name` string, required — The name of the folder.
    - `parent_folder_id` string, nullable, required — The ID of the folder's parent folder, or null if the folder is a top-level folder in the team.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

- **2026-08-11** `d7ab5681d84c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v2/teams/:team_id/folders/get.md)

---

[API](https://skmtc.dev/figma/apis/figma-api.md) · [All operations](https://skmtc.dev/figma/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/figma/figma-api/revisions/d7ab5681d84c/schema)