# FindResponse

The files and directories a find matched.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `results` | [`FindResultEntry`](https://docs.maitento.com/reference/types/find-result-entry.md)`[]` | The matching files/directories. |
| `totalFound` | `integer` | Total number of matches found (may be more than `results` holds, when it was cut short). |
| `truncated` | `boolean` | True if `results` was cut short at `maxResults`. |

## Example

```json
{
  "results": [
    {
      "path": "...",
      "type": "...",
      "size": 0,
      "dateModified": "2026-10-26T12:00:00.0000000Z",
      "grepMatches": [],
      "preview": "..."
    }
  ],
  "totalFound": 0,
  "truncated": false
}
```

## Where it's used

- [`vfs.open(name).find`](https://docs.maitento.com/reference/api/vfs.md) (`POST /namespaces/{namespaceName}/vfs/by-name/{name}/find`)
- [`vfs.openById(id).find`](https://docs.maitento.com/reference/api/vfs.md) (`POST /vfs/by-id/{id}/find`)