---
title: "Retrieve a (partial) file list"
method: GET
path: "/rr_filelist"
---

# Retrieve a (partial) file list

`GET /rr_filelist`

## Query parameters

- `dir` string, required
- `first` number
- `max` number

## Response `200`

File list result

- object
  - `dir` string — Queried directory
  - `first` number — First item index returned
  - `files` object[]
    - `type` 'd' | 'f' — Type of this item (d = directory, f = file)
    - `name` string — Filename of this item
    - `size` number — Size of this item in bytes
    - `date` string, date-time — Last modified datetime of this item
  - `next` number — Index of the next item to query or 0 if there are no more items
  - `err` number — Error code - `0`: List query successful - `1`: Drive is not mounted - `2`: Directory does not exist

## Other responses

- `503` — Insufficient RAM to provide a response

## Changes

> 5 revisions in range; 1 could not be searched.

- **2024-10-22** `2fc466818054` — 1 info
  - added the new optional `query` request parameter `max`
- **2022-05-06** `97e906df51c7` — 1 warning
  - deleted the `query` request parameter `max`

[Change history](https://skmtc.dev/duet3d/apis/reprapfirmware/changes/rr_filelist/get.md)

---

[API](https://skmtc.dev/duet3d/apis/reprapfirmware.md) · [All operations](https://skmtc.dev/duet3d/apis/reprapfirmware/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/duet3d/reprapfirmware/revisions/23ee8854e806/schema)