---
title: DeviceConnection type | Wartiva GraphQL API
description: Connection for Device edges with total count. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/device-connection.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `DeviceConnection` type

Connection for [Device](https://wartiva.com/api-docs/types/device.html) edges with total count.

## Fields

| Field Name | Description |
|---|---|
| `edges` - [`[DeviceEdge!]!`](https://wartiva.com/api-docs/types/device-edge.html) | The [Device](https://wartiva.com/api-docs/types/device.html) edges. |
| `total` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | Total number of [Device](https://wartiva.com/api-docs/types/device.html) edges matching the query. |
| `searchInput` - [`GraphSearchQueryInputPayload`](https://wartiva.com/api-docs/types/graph-search-query-input-payload.html) | The graph search query that reproduces this connection. Submit it as the query of a [GraphSearchInput](https://wartiva.com/api-docs/types/graph-search-input.html) to retrieve the same [Device](https://wartiva.com/api-docs/types/device.html) objects as a standalone search, with full filtering, sorting, and pagination. Null when this connection was not produced from a graph relationship traversal. |

## Used by

- [`DeviceManufacturer`](https://wartiva.com/api-docs/types/device-manufacturer.html) type: A hardware vendor that made one or more discovered Device objects in an organization.
- [`DeviceModel`](https://wartiva.com/api-docs/types/device-model.html) type: A specific product model, made by a DeviceManufacturer, that one or more discovered Device objects in an organization are instances of.
- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) type: A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
- [`Network`](https://wartiva.com/api-docs/types/network.html) type: An IP network (subnet) that a managed Endpoint has been attached to, identified by its address range in CIDR notation and, for networks outside a…
- [`NetworkPrefix`](https://wartiva.com/api-docs/types/network-prefix.html) type: A specific IP address together with its subnet prefix length (e.g.
- [`PositionSeen`](https://wartiva.com/api-docs/types/position-seen.html) type: A geographic coordinate (latitude and longitude) where a managed Endpoint was observed, and the times it was seen there.

## 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…

## Example

### Example

```json
{
  "edges": [DeviceEdge],
  "total": 123,
  "searchInput": GraphSearchQueryInputPayload
}

```

---

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