---
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
    - `read_only` 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
    - `read_only` 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` PrintFileRefs — Reference links for file thumbnail, icon and download
      - `download` string
      - `icon` string
      - `thumbnail` string
    - `meta` PrintFileMetadata — Print file metadata parsed from G-code or SL1, all data are optional
      - `bed_temperature` integer — Degrees Celsius
      - `bed_temperature per tool` integer[]
      - `temperature` integer — Nozzle temperature, Degrees Celsius
      - `temperature per tool` integer[]
      - `brim_width` integer — Millimeters
      - `estimated printing time (normal mode)` string
      - `estimated_print_time` integer — Seconds
      - `faded_layers` integer
      - `filament cost` number
      - `filament cost per tool` number[]
      - `filament used [cm3]` number
      - `filament used [cm3] per tool` number[]
      - `filament used [g]` number
      - `filament used [g] per tool` number[]
      - `filament used [mm]` number
      - `filament used [mm] per tool` number[]
      - `filament_type` string
      - `filament_type per tool` string[]
      - `fill_density` string — Percents
      - `initial_exposure_time` integer — Seconds
      - `layer_height` number — Millimeters
      - `material_name` string
      - `exposure_time` integer — Seconds
      - `max_exposure_time` integer — Seconds
      - `max_initial_exposure_time` integer — Seconds
      - `min_exposure_time` integer — Seconds
      - `min_initial_exposure_time` integer — Seconds
      - `nozzle_diameter` number — Millimeters
      - `nozzle_diameter per tool` number[]
      - `normal_percent_present` boolean
      - `normal_left_present` boolean
      - `quiet_percent_present` boolean
      - `quiet_left_present` boolean
      - `layer_info_present` boolean
      - `max_layer_z` number
      - `print_time` integer — Seconds
      - `printer_model` 'MK3' | 'MK3S' | 'MINI'
      - `support_material` string
      - `ironing` integer
      - `required_resin_ml` number
      - `profile` string
  - FirmwareFileInfo — Basic file info object, common for all files
    - `name` string, required — Short Filename
    - `read_only` 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
    - `read_only` 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` union[]
      - union
        - FileInfo — Basic file info object, common for all files
          - `name` string, required — Short Filename
          - `read_only` 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
          - `read_only` 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` PrintFileRefs — Reference links for file thumbnail, icon and download
            - `download` string
            - `icon` string
            - `thumbnail` string
        - FirmwareFileInfoBasic — Basic file info object, common for all files
          - `name` string, required — Short Filename
          - `read_only` 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

---

[API](https://skmtc.net/prusa3d/apis/prusalink-web.md) · [All operations](https://skmtc.net/prusa3d/apis/prusalink-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prusa3d/prusalink-web/versions/e0a5f7abc4df/schema)