---
title: "Get files in a folder"
method: GET
path: "/v2/folders/{folder_id}/files"
tags: ["Folders"]
---

# Get files in a folder

`GET /v2/folders/{folder_id}/files`

Get a list of the files directly within the specified folder.

## Path parameters

- `folder_id` string, required

## Query parameters

- `branch_data` boolean

## Response `200`

Response from the GET /v2/folders/{folder_id}/files endpoint.

- object
  - `name` string, required — The folder's name.
  - `files` object[], required — An array of the files directly in the folder.
    - `key` string, required — The file's key.
    - `name` string, required — The file's name.
    - `thumbnail_url` string — The file's thumbnail URL.
    - `last_modified` string, date-time, required — The UTC ISO 8601 time at which the file was last modified.
    - `branches` object[] — Present only when `branch_data` is true and the file has branches. An array of the file's branches.
      - `key` string, required — The branch's file key.
      - `name` string, required — The branch's name.
      - `thumbnail_url` string — The branch's thumbnail URL.
      - `last_modified` string, date-time, required — The UTC ISO 8601 time at which the branch was last modified.

## 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/folders/:folder_id/files/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)