---
title: "List files"
method: GET
path: "/devices/{deviceId}/files"
tags: ["Tools/Files"]
---

# List files

`GET /devices/{deviceId}/files`

Lists the files at the directory path given in the path query parameter, returning each entry's metadata along with the path and total count.

## Path parameters

- `deviceId` string, required

## Query parameters

- `path` string, required

## Headers

- `X-Device-Display-ID` integer

## Response `200`

OK

- FileListBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `files` FileInfo[], nullable, required
    - `extendedAttributes` boolean, required
    - `group` string, required
    - `hardLinks` integer, required
    - `modifiedAt` string, date-time, required
    - `name` string, required
    - `owner` string, required
    - `permissions` FilePermissions, required
      - `group` PermissionSet, required
        - `execute` boolean, required
        - `read` boolean, required
        - `write` boolean, required
      - `others` PermissionSet, required
        - `execute` boolean, required
        - `read` boolean, required
        - `write` boolean, required
      - `owner` PermissionSet, required
        - `execute` boolean, required
        - `read` boolean, required
        - `write` boolean, required
      - `special` SpecialPermissions, required
        - `setGid` boolean, required
        - `setUid` boolean, required
        - `sticky` boolean, required
    - `size` integer, required
    - `symlinkTarget` string
    - `type` string, required
  - `path` string, required
  - `total` integer, required

## Other responses

- `default` — Error

## Changes

- **2026-07-07** `d5d1e5ee8188` — 2 info
  - api tag `Tools/Files` added
  - api tag `Tools` removed
- **2026-06-29** `3cb3612f45e0` — 1 info
  - endpoint added
- **2026-06-29** `8ea6db3daeac` — 1 breaking
  - api path removed without deprecation
- **2026-05-11** `12719a46e639` — 2 info
  - api tag `Tools` added
  - api tag `tools` removed

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/devices/:deviceId/files/get.md)

---

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