---
title: EndpointPathEntrySearchMatch type | Wartiva GraphQL API
description: One path search match: a discovered file entry together with the EndpointPath whose sensor collected it. Wartiva GraphQL API reference with examples.
url: https://wartiva.com/api-docs/types/endpoint-path-entry-search-match.html
updated: 2026-10-07
---

File path sensors · GraphQL type

# `EndpointPathEntrySearchMatch` type

One path search match: a discovered file entry together with the [EndpointPath](https://wartiva.com/api-docs/types/endpoint-path.html) whose sensor collected it. The match's `stats` and `contents` fields load the file's stat record and collected bytes on demand — they cost nothing unless selected, and are equivalent to calling [endpointPathEntryStats](https://wartiva.com/api-docs/queries/endpoint-path-entry-stats.html) / [endpointPathEntryContents](https://wartiva.com/api-docs/queries/endpoint-path-entry-contents.html) with this match's EndpointPath id.

## Fields

| Field Name | Description |
|---|---|
| `endpointPath` - [`EndpointPath!`](https://wartiva.com/api-docs/types/endpoint-path.html) | The EndpointPath whose sensor collected the matching file. |
| `entry` - [`EndpointPathEntry!`](https://wartiva.com/api-docs/types/endpoint-path-entry.html) | The matching discovered entry. |
| `stats` - [`EndpointPathEntryStats`](https://wartiva.com/api-docs/types/endpoint-path-entry-stats.html) | The matched file's stat record, loaded from alternate data only when this field is selected (one stats record read per match). Null when the record has been removed (e.g. the owning object is being deleted). |
| `contents` - [`EndpointPathEntryContents`](https://wartiva.com/api-docs/types/endpoint-path-entry-contents.html) | The matched file's collected contents, resolved only when this field is selected. Null when no contents are stored for the file (e.g. the sensor does not collect contents, or the file was reported deleted). Selecting this field alone checks only the contents record's existence; the file bytes are read from storage when the node's `contentsAsString` is selected. |

## Used by

- [`EndpointPathEntrySearchPayload`](https://wartiva.com/api-docs/types/endpoint-path-entry-search-payload.html) type: One page of exact-path matches across every PathSensor on an Endpoint, returned by endpointPathEntrySearch.

## Related types

- [`EndpointPath`](https://wartiva.com/api-docs/types/endpoint-path.html) The single graph object a PathSensor produces on an Endpoint, so an Endpoint has one EndpointPath per sensor that has reported data from it; list…
- [`EndpointPathEntryContents`](https://wartiva.com/api-docs/types/endpoint-path-entry-contents.html) The collected contents of one file a PathSensor discovered, retrieved with endpointPathEntryContents.
- [`EndpointPathEntryStats`](https://wartiva.com/api-docs/types/endpoint-path-entry-stats.html) The stat record of one file a PathSensor discovered, stored as alternate data on the owning EndpointPath object and retrieved with…

## Example

### Example

```json
{
  "endpointPath": EndpointPath,
  "entry": EndpointPathEntry,
  "stats": EndpointPathEntryStats,
  "contents": EndpointPathEntryContents
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt