---
title: endpointPathEntrySearch query | Wartiva GraphQL API
description: Checks whether an exact file path exists on an Endpoint, checking the collected paths of every PathSensor on the endpoint (every EndpointPath found on it).
url: https://wartiva.com/api-docs/queries/endpoint-path-entry-search.html
updated: 2026-10-07
---

File path sensors · GraphQL query

# `endpointPathEntrySearch` query

Checks whether an exact file path exists on an [Endpoint](https://wartiva.com/api-docs/types/endpoint.html), checking the collected paths of every PathSensor on the endpoint (every [EndpointPath](https://wartiva.com/api-docs/types/endpoint-path.html) found on it). The given path must equal a collected path exactly (case-sensitive); one match is returned per sensor that collected it, so sensors with overlapping scopes can each contribute a match for the same file. An empty result (total 0) means no sensor has collected the path. No file data is read — each match names the path, when its record was last stored, and the owning EndpointPath; retrieve the file's stat record and collected bytes with [endpointPathEntryStats](https://wartiva.com/api-docs/queries/endpoint-path-entry-stats.html) and [endpointPathEntryContents](https://wartiva.com/api-docs/queries/endpoint-path-entry-contents.html) using the match's EndpointPath id.

## Response

Returns an [`EndpointPathEntrySearchPayload!`](https://wartiva.com/api-docs/types/endpoint-path-entry-search-payload.html)

## Arguments

| Name | Description |
|---|---|
| `endpointId` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The Endpoint identifier. |
| `path` - [`String!`](https://wartiva.com/api-docs/types/string.html) | The absolute file path to check for, exactly as reported by the endpoint. Must be non-empty. |
| `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) | Maximum number of matches to return. Default = `100` |
| `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) | Number of matches to skip. Default = `0` |
| `mockOptions` - [`MockDataInput`](https://wartiva.com/api-docs/types/mock-data-input.html) | Options for mock data generation. Options supported: key: "PLATFORM", value: OsPlatform example: "mockOptions": { "options": [ { "key": "PLATFORM", "value": "WINDOWS" } ] } |

## Example

### Query

```graphql
query endpointPathEntrySearch(
  $endpointId: ID!,
  $path: String!,
  $limit: Int,
  $skip: Int,
  $mockOptions: MockDataInput
) {
  endpointPathEntrySearch(
    endpointId: $endpointId,
    path: $path,
    limit: $limit,
    skip: $skip,
    mockOptions: $mockOptions
  ) {
    nodes {
      endpointPath {
        ...EndpointPathFragment
      }
      entry {
        ...EndpointPathEntryFragment
      }
      stats {
        ...EndpointPathEntryStatsFragment
      }
      contents {
        ...EndpointPathEntryContentsFragment
      }
    }
    total
  }
}

```

### Variables

```json
{
  "endpointId": 4,
  "path": "xyz789",
  "limit": 100,
  "skip": 0,
  "mockOptions": MockDataInput
}

```

### Response

```json
{
  "data": {
    "endpointPathEntrySearch": {
      "nodes": [EndpointPathEntrySearchMatch],
      "total": 987
    }
  }
}

```

---

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