---
title: "List Sandbox Files"
method: GET
path: "/v2/sandboxes/{sandbox_id}/files"
tags: ["Sandboxes"]
---

# List Sandbox Files

`GET /v2/sandboxes/{sandbox_id}/files`

List files in a sandbox directory.

## Path parameters

- `sandbox_id` string, required

## Query parameters

- `path` string

## Response `200`

Default Response

- object
  - `files` object[], required — Entries in the requested directory
    - `name` string, required — File or directory name (basename)
    - `path` string, required — Absolute path inside the sandbox
    - `type` 'file' | 'dir', required — Whether this entry is a regular file or a directory
    - `size_bytes` number, required — Size of the file in bytes (0 for directories)

## Other responses

- `401` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)