# List a directory

> One level, sorted by name.

`GET https://api.zavu.dev/v1/sandboxes/{sandboxId}/files/list`

One level, sorted by name.

## Parameters

- `sandboxId` (path, string, required): Sandbox ID.
- `path` (query, string)

## Responses

### 200

Entries.

- `path` (string, required)
- `files` (object[], required)
  - `name` (string, required)
  - `path` (string, required)
  - `isDir` (boolean, required)
  - `size` (integer, required)
  - `modifiedAt` (string<date-time>, required)
- `truncated` (boolean, required): True when the directory holds more than 10,000 entries.

### 400

Invalid path.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

### 401

Unauthorized.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

### 404

Sandbox not found, or it belongs to another project.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

### 409

`sandbox_not_running`: the sandbox is stopped, stopping, failed or deleted; resume it first. `sandbox_not_ready`: it is still starting and did not become ready in time; retry.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

## Example

```bash
curl -X GET "https://api.zavu.dev/v1/sandboxes/sandbox_abc123/files/list" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"
```

```typescript
import Zavudev from "@zavudev/sdk";

const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY });

const result = await zavu.sandboxes.files.list("sandbox_abc123");

console.log(result);
```