---
title: SensorRequestRun type | Wartiva GraphQL API
description: The record of one attempt to run a SensorRequest: when it ran, which sensor version ran it, which Endpoint ran it.
url: https://wartiva.com/api-docs/types/sensor-request-run.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `SensorRequestRun` type

The record of one attempt to run a [SensorRequest](https://wartiva.com/api-docs/types/sensor-request.html): when it ran, which sensor version ran it, which [Endpoint](https://wartiva.com/api-docs/types/endpoint.html) ran it (none for PUBLIC-zone runs, which the vendor system performs), how it ended, and the open ports and network services it reported. The system records a run for every attempt, whatever its `result`; only a COMPLETED run updates the [Service](https://wartiva.com/api-docs/types/service.html) and [OpenPort](https://wartiva.com/api-docs/types/open-port.html) objects in the graph. Reach runs through `SensorRequest.runs`, `Device.sensorRequestRuns`, or [sensorRequestRun](https://wartiva.com/api-docs/queries/sensor-request-run.html).

## Fields

| Field Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | A string uniquely identifying this SensorRequestRun. |
| `sensorRequestId` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The unique identifier of the SensorRequest that was run. |
| `sensorRequest` - [`SensorRequest!`](https://wartiva.com/api-docs/types/sensor-request.html) | The SensorRequest that was run. |
| `timestamp` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time the run completed. |
| `version` - [`String!`](https://wartiva.com/api-docs/types/string.html) | The version of the software that ran the request. |
| `device` - [`Device!`](https://wartiva.com/api-docs/types/device.html) | The Device the sensor request was run against. |
| `endpoint` - [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) | The Endpoint that performed this run. Null for PUBLIC-zone runs, which the vendor system performs, and when the Endpoint no longer exists. |
| `result` - [`SensorRequestRunResult!`](https://wartiva.com/api-docs/types/sensor-request-run-result.html) | Reports the end state of the request run. |
| `errors` - [`[String!]`](https://wartiva.com/api-docs/types/string.html) | A list of errors encountered during the run. |
| `ports` - [`[OpenPortSummary!]`](https://wartiva.com/api-docs/types/open-port-summary.html) | Summary of the ports the run reported, open or closed. |
| `services` - [`[ServiceSummary!]`](https://wartiva.com/api-docs/types/service-summary.html) | Summary of the network services the run reported, up or down. |
| `portsFound` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of entries in `ports` that were open. |
| `servicesFound` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | The number of entries in `services` that were up. |

## Returned by

- [`sensorRequestRun`](https://wartiva.com/api-docs/queries/sensor-request-run.html) query: Retrieves a SensorRequestRun: the record of one attempt to run a SensorRequest, with its outcome, the endpoint that ran it when one did, and the…

## Used by

- [`Device`](https://wartiva.com/api-docs/types/device.html) type: A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
- [`SensorRequest`](https://wartiva.com/api-docs/types/sensor-request.html) type: A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.
- [`SensorRequestRunPayload`](https://wartiva.com/api-docs/types/sensor-request-run-payload.html) type: Payload wrapper for a single SensorRequestRun result.

## Related types

- [`Device`](https://wartiva.com/api-docs/types/device.html) A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
- [`SensorRequest`](https://wartiva.com/api-docs/types/sensor-request.html) A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.

## Example

### Example

```json
{
  "id": "4",
  "sensorRequestId": 4,
  "sensorRequest": SensorRequest,
  "timestamp": "2021-10-07T18:23:25.829Z",
  "version": "abc123",
  "device": Device,
  "endpoint": Endpoint,
  "result": "COMPLETED",
  "errors": ["xyz789"],
  "ports": [OpenPortSummary],
  "services": [ServiceSummary],
  "portsFound": 123,
  "servicesFound": 987
}

```

---

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