# List a directory

`GET /v1/sandboxes/{sandbox}/files/list`

**In this build:** Works on the simulator or a real VM.

**Scope:** `file.read`

**CLI:** `harebox file ls`

## Query

`path`, `limit`, `cursor`

## Response: 200

`FileList`

| Field | Type | Notes |
|---|---|---|
| `entries` (required) | `array` |  |
| `next_cursor` | `string or null` |  |

Errors follow [one format](../errors.html).