---
title: "file metadata"
method: GET
path: "/api/v1/files/{storage}/{path}"
---

# file metadata

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

## Response `200`

OK

- union
  - FileInfo
    - `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
  - PrintFileInfo
    - `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
    - `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
    - `refs` object
      - `download` string
      - `icon` string
      - `thumbnail` string
  - FirmwareFileInfo
    - `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
    - `meta` object
      - `version` string — Firmware version in text format
      - `printer_type` integer
      - `printer_version` integer
  - FolderInfo
    - `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
          - `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
        - PrintFileInfo
          - `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
          - `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
          - `refs` object
            - `download` string
            - `icon` string
            - `thumbnail` string
        - FirmwareFileInfo
          - `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
          - `meta` object
            - `version` string — Firmware version in text format
            - `printer_type` integer
            - `printer_version` integer
        - FolderInfo — recursive

## Other responses

- `401` — Unauthorized

## Changes

- **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 changed from `object` to no type 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
- **2022-11-22** `fe2b315c3728` — 4 warning, 3 info
  - added the new `FILE` enum value to the `type` response property for the response status `200`
  - added the new `FIRMWARE` enum value to the `type` response property for the response status `200`
  - added the new `FOLDER` enum value to the `type` response property for the response status `200`
  - added the new `PRINT_FILE` enum value to the `type` response property for the response status `200`
  - …3 more
- **2022-06-29** `868974146778` — 4 info
  - added the new optional `header` request parameter `Accept` to all path's operations
  - added the new optional `header` request parameter `Accept-Language` to all path's operations
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
- **2022-05-26** `fe139cc78ad4` — 1 info
  - endpoint added
- …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/f1205c950e45/schema)