---
title: sensorRequestRun query | Wartiva GraphQL API
description: Retrieves a SensorRequestRun: the record of one attempt to run a SensorRequest, with its outcome, the endpoint that ran it when one did.
url: https://wartiva.com/api-docs/queries/sensor-request-run.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL query

# `sensorRequestRun` query

Retrieves a [SensorRequestRun](https://wartiva.com/api-docs/types/sensor-request-run.html): the record of one attempt to run a [SensorRequest](https://wartiva.com/api-docs/types/sensor-request.html), with its outcome, the endpoint that ran it when one did, and the ports and services it reported. Only a completed run adds the open ports and services it found to the security graph. Restricted to organization administrators.

## Response

Returns a [`SensorRequestRunPayload!`](https://wartiva.com/api-docs/types/sensor-request-run-payload.html)

## Arguments

| Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The unique identifier of the SensorRequestRun. |

## Example

### Query

```graphql
query sensorRequestRun($id: ID!) {
  sensorRequestRun(id: $id) {
    sensorRequestRun {
      id
      sensorRequestId
      sensorRequest {
        ...SensorRequestFragment
      }
      timestamp
      version
      device {
        ...DeviceFragment
      }
      endpoint {
        ...EndpointFragment
      }
      result
      errors
      ports {
        ...OpenPortSummaryFragment
      }
      services {
        ...ServiceSummaryFragment
      }
      portsFound
      servicesFound
    }
  }
}

```

### Variables

```json
{"id": "4"}

```

### Response

```json
{
  "data": {
    "sensorRequestRun": {
      "sensorRequestRun": SensorRequestRun
    }
  }
}

```

---

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