---
title: sensorRequest query | Wartiva GraphQL API
description: Retrieves a SensorRequest: a standing request to run one Sensor against one device IP address, and optionally one port.
url: https://wartiva.com/api-docs/queries/sensor-request.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL query

# `sensorRequest` query

Retrieves a [SensorRequest](https://wartiva.com/api-docs/types/sensor-request.html): a standing request to run one [Sensor](https://wartiva.com/api-docs/types/sensor.html) against one device IP address, and optionally one port, with its expiration and completion state. Requests are created automatically when devices, open ports, and services are discovered, or on demand with [sensorRequestSubmit](https://wartiva.com/api-docs/mutations/sensor-request-submit.html); each attempt is recorded as a [SensorRequestRun](https://wartiva.com/api-docs/types/sensor-request-run.html). Restricted to organization administrators.

## Response

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

## Arguments

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

## Example

### Query

```graphql
query sensorRequest($id: ID!) {
  sensorRequest(id: $id) {
    sensorRequest {
      id
      device {
        ...DeviceFragment
      }
      sensor {
        ...SensorFragment
      }
      zone
      ip {
        ...IpAddressFragment
      }
      protocol
      port
      args
      created
      state {
        ...SensorRequestStateFragment
      }
      runIds
      runs {
        ...SensorRequestRunFragment
      }
    }
  }
}

```

### Variables

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

```

### Response

```json
{
  "data": {
    "sensorRequest": {"sensorRequest": SensorRequest}
  }
}

```

---

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