---
title: "File or folder metadata"
method: GET
path: "/api/v1/files/{storage}/{path}"
---

# File or folder metadata

`GET /api/v1/files/{storage}/{path}`

## Response `200`

OK

- union
  - FileInfo — Basic file info object, common for all files
    - `name` string, required — Short Filename
    - `ro` boolean, required
    - `size` integer — Available for files only, not for folders
    - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
    - `m_timestamp` integer, required — Timestamp in seconds
    - `display_name` string — Long Filename
    - `refs` object
      - `download` string
  - PrintFileInfo — Basic file info object, common for all files
    - `name` string, required — Short Filename
    - `ro` boolean, required
    - `size` integer — Available for files only, not for folders
    - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
    - `m_timestamp` integer, required — Timestamp in seconds
    - `display_name` string — Long Filename
    - `refs` object
      - `download` string
      - `icon` string
      - `thumbnail` string
    - `meta` object — Print file metadata parsed from G-code, all data are optional
      - `bed_temperature` string — Degrees Celsius
      - `nozzle_temperature` string — Degrees Celsius
      - `brim_width` string — Milimeters
      - `estimated printing time (normal mode)` string
      - `faded_layers` string
      - `filament cost` string
      - `filament used [cm3]` string
      - `filament used [g]` string
      - `filament used [mm]` string
      - `filament_type` string
      - `fill_density` string — Percent
      - `initial_exposure_time` string — Seconds
      - `layer_height` string — Milimeters
      - `material_name` string
      - `exposure_time` string — Seconds
      - `max_exposure_time` string — Seconds
      - `max_initial_exposure_time` string — Seconds
      - `min_exposure_time` string — Seconds
      - `min_initial_exposure_time` string — Seconds
      - `nozzle_diameter` string — Milimeters
      - `print_time` integer — Seconds
      - `printer_model` 'MK3' | 'MK3S' | 'MINI'
      - `support_material` string
      - `ironing` string
      - `required_resin_ml` string
      - `profile` string
  - FirmwareFileInfo — Basic file info object, common for all files
    - `name` string, required — Short Filename
    - `ro` boolean, required
    - `size` integer — Available for files only, not for folders
    - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
    - `m_timestamp` integer, required — Timestamp in seconds
    - `display_name` string — Long Filename
    - `refs` object
      - `download` string
    - `meta` object
      - `version` string — Firmware version in text format
      - `printer_type` integer
      - `printer_version` integer
  - FolderInfo — Basic file info object, common for all files
    - `name` string, required — Short Filename
    - `ro` boolean, required
    - `size` integer — Available for files only, not for folders
    - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
    - `m_timestamp` integer, required — Timestamp in seconds
    - `display_name` string — Long Filename
    - `children` object[]
      - `schema` union
        - FileInfo — Basic file info object, common for all files
          - `name` string, required — Short Filename
          - `ro` boolean, required
          - `size` integer — Available for files only, not for folders
          - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
          - `m_timestamp` integer, required — Timestamp in seconds
          - `display_name` string — Long Filename
          - `refs` object
            - `download` string
        - PrintFileInfoBasic — Basic file info object, common for all files
          - `name` string, required — Short Filename
          - `ro` boolean, required
          - `size` integer — Available for files only, not for folders
          - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
          - `m_timestamp` integer, required — Timestamp in seconds
          - `display_name` string — Long Filename
          - `refs` object
            - `download` string
            - `icon` string
            - `thumbnail` string
        - FirmwareFileInfoBasic — Basic file info object, common for all files
          - `name` string, required — Short Filename
          - `ro` boolean, required
          - `size` integer — Available for files only, not for folders
          - `type` 'PRINT_FILE' | 'FIRMWARE' | 'FILE' | 'FOLDER', required — File could be print file, firmware file, other (e.g. configuration) file, or folder
          - `m_timestamp` integer, required — Timestamp in seconds
          - `display_name` string — Long Filename
          - `refs` object
            - `download` string
        - FolderInfo — recursive

## Other responses

- `401` — Unauthorized

## Changes

- **2023-01-19** `418be1c4e97c` — 10 breaking, 5 warning, 10 info
  - the `oneOf[#/components/schemas/FileInfo]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `oneOf[#/components/schemas/FolderInfo]/allOf[subschema #2]/children/items/schema/anyOf[#/components/schemas/FileInfo]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `oneOf[#/components/schemas/FileInfo]/m_timestamp` from the response with the `200` status
  - removed the required property `oneOf[#/components/schemas/FileInfo]/name` from the response with the `200` status
  - …21 more
- **2022-12-14** `f1205c950e45` — 2 breaking, 8 warning, 1 info
  - added `#/components/schemas/FileInfo, #/components/schemas/PrintFileInfo, #/components/schemas/FirmwareFileInfo, #/components/schemas/FolderInfo` to the response body `oneOf` list for the response status `200`
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `creation_timestamp` from the response with the `200` status
  - removed the optional property `display_name` from the response with the `200` status
  - …7 more
- …earlier changes not shown

[Full history](https://skmtc.dev/prusa3d/apis/prusalink-web/changes/api/v1/files/:storage/:path/get.md)

---

[API](https://skmtc.dev/prusa3d/apis/prusalink-web.md) · [All operations](https://skmtc.dev/prusa3d/apis/prusalink-web/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prusa3d/prusalink-web/revisions/418be1c4e97c/schema)