# Find text in files

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

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

**Scope:** `file.read`

**CLI:** `harebox file grep`

## Query

`path`, `query`, `limit`, `cursor`

## Response: 200

`TextMatchList`

| Field | Type | Notes |
|---|---|---|
| `matches` | `array` |  |
| `next_cursor` | `string or null` |  |

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