---
title: sensorScopes query | Wartiva GraphQL API
description: Lists an organization's SensorScope rules, including disabled ones. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/queries/sensor-scopes.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL query

# `sensorScopes` query

Lists an organization's [SensorScope](https://wartiva.com/api-docs/types/sensor-scope.html) rules, including disabled ones. Each scope controls which [Sensor](https://wartiva.com/api-docs/types/sensor.html) probes may run against which devices, filtered by IP address class, physical location, network, and the number of endpoints seen on a network. A sensor may run when any enabled scope allows it and the device's IP address passes every enabled filter of that scope; multicast addresses are never probed. Every organization has a default scope. Restricted to organization administrators.

## Response

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

## Arguments

| Name | Description |
|---|---|
| `orgId` - [`OrganizationId!`](https://wartiva.com/api-docs/types/organization-id.html) | The id of the Organization to retrieve SensorScopes for. |

## Example

### Query

```graphql
query sensorScopes($orgId: OrganizationId!) {
  sensorScopes(orgId: $orgId) {
    sensorScopes {
      id
      orgId
      enabled
      isDefault
      name
      description
      autoAddNewSensors
      sensors {
        ...SensorFragment
      }
      disabledSensors {
        ...SensorFragment
      }
      filterIpProtocol {
        ...SensorFilterIpProtocolFragment
      }
      filterLocations {
        ...SensorFilterLocationsFragment
      }
      filterNetworks {
        ...SensorFilterNetworksFragment
      }
      filterNumEndpoints {
        ...SensorFilterNumEndpointsFragment
      }
      created
      lastUpdateFromDefault
      lastUpdateByUser
      defaultScopeVersion
    }
  }
}

```

### Variables

```json
{"orgId": "615f3b3b28284380e28a7342"}

```

### Response

```json
{
  "data": {
    "sensorScopes": {"sensorScopes": [SensorScope]}
  }
}

```

---

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