---
title: InterfaceConnection type | Wartiva GraphQL API
description: Collection payload for Interface edges with total count. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/interface-connection.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `InterfaceConnection` type

Collection payload for Interface edges with total count.

## Fields

| Field Name | Description |
|---|---|
| `edges` - [`[InterfaceEdge!]!`](https://wartiva.com/api-docs/types/interface-edge.html) | The Interface edges. |
| `total` - [`Int!`](https://wartiva.com/api-docs/types/int.html) | Total number of Interface 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 [Interface](https://wartiva.com/api-docs/types/interface.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

- [`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.

## Related types

- [`Interface`](https://wartiva.com/api-docs/types/interface.html) A network interface (physical, virtual, loopback, or tunnel) on an Endpoint, collected from Windows, macOS, and Linux endpoints as part of the…

## Example

### Example

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

```

---

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