---
title: "Retrieve the list of files uploaded to the project (scope: files.read)"
method: GET
path: "/workspace/{workspace-id}/project/{project-id}/files"
tags: ["Project"]
---

# Retrieve the list of files uploaded to the project (scope: files.read)

`GET /workspace/{workspace-id}/project/{project-id}/files`

## Path parameters

- `workspace-id` string, required
- `project-id` string, required

## Response `200`

The list of files was retrieved successfully

- object
  - `workspace` string, required — The workspace id (matches the workspace-id sent with the request)
  - `project` string, required — The project id (matches the project-id sent with the request)
  - `files` object[], required
    - `filename` string, required — The name of the file including its extension
    - `size` number — The size of the file in bytes
    - `contentType` string — MIME type of the file
    - `url` string, uri — URL where the file can be downloaded
    - `metadata` union
      - object — Metadata for font files (contentType is font/*)
        - `family` string — Font family name
        - `subFamily` string — Font subfamily name
        - `weight` number — Numeric font weight
        - `style` 'normal' | 'italic' | 'oblique' — Font style
      - object — Metadata for image files (contType is image/*)
        - `width` number — Image width in pixels
        - `height` number — Image height in pixels
        - `description` string — Description of the image for use as the alt text

## Other responses

- `400` — The request is invalid.
- `401` — The request does not have valid authentication.
- `403` — The client does not have authorization to make the request.
- `404` — The requested endpoint or resource could not be found.
- `429` — The number of API requests made to the workspace has exceeded the allowed threshold.

---

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