---
title: "Get files in a project"
method: GET
path: "/v1/projects/{project_id}/files"
tags: ["Projects"]
---

# Get files in a project

`GET /v1/projects/{project_id}/files`

Get a list of all the Files within the specified project.

## Path parameters

- `project_id` string, required

## Query parameters

- `branch_data` boolean

## Response `200`

Response from the GET /v1/projects/{project_id}/files endpoint.

- object
  - `name` string, required — The project's name.
  - `files` object[], required — An array of files.
    - `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.

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

---

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