---
title: wlanInterfaceConnection query | Wartiva GraphQL API
description: Retrieves a WlanInterfaceConnection by its graph object id: an endpoint Wi-Fi adapter's association with one network and access point, with its security.
url: https://wartiva.com/api-docs/queries/wlan-interface-connection.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL query

# `wlanInterfaceConnection` query

Retrieves a [WlanInterfaceConnection](https://wartiva.com/api-docs/types/wlan-interface-connection.html) by its graph object id: an endpoint Wi-Fi adapter's association with one network and access point, with its security, signal, and link-rate details. A [WlanInterface](https://wartiva.com/api-docs/types/wlan-interface.html) lists its current connections through `connections` and their history through `connectionsSeen`; find them across endpoints with [graphSearch](https://wartiva.com/api-docs/queries/graph-search.html) on the WLAN_INTERFACE_CONNECTION object type. Returns a not-found error when no object has the id, and an error when the id belongs to another object type.

## Response

Returns a [`WlanInterfaceConnectionPayload!`](https://wartiva.com/api-docs/types/wlan-interface-connection-payload.html)

## Arguments

| Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The WlanInterfaceConnection identifier. |
| `mockOptions` - [`MockDataInput`](https://wartiva.com/api-docs/types/mock-data-input.html) | Options for mock data generation. Options supported: key: "PLATFORM", value: OsPlatform example: "mockOptions": { "options": [ { "key": "PLATFORM", "value": "WINDOWS" } ] } |

## Example

### Query

```graphql
query wlanInterfaceConnection(
  $id: ID!,
  $mockOptions: MockDataInput
) {
  wlanInterfaceConnection(
    id: $id,
    mockOptions: $mockOptions
  ) {
    node {
      id
      orgId
      seen {
        ...SeenOnlineFragment
      }
      objectType
      objectTypeLabel
      displayName
      firstSeen
      lastSeen
      createdAt
      updatedAt
      snapshotInfo {
        ...GraphObjectSnapshotInfoFragment
      }
      interfaceId
      ssid
      securityEnabled
      authAlgo
      cipherAlgo
      interfaceMode
      bssId
      physicalType
      rssiDbm
      noiseDbm
      channelNumber
      channelWidth
      channelBand
      rxRateBitsPerSecond
      txRateBitsPerSecond
      accessPoint {
        ...WlanAccessPointFragment
      }
      wlanInterface {
        ...WlanInterfaceFragment
      }
      networks {
        ...NetworkConnectionFragment
      }
      networksSeenConnectedTo {
        ...NetworkConnectionFragment
      }
      findings {
        ...FindingsPayloadFragment
      }
      issues {
        ...IssuesPayloadFragment
      }
      issuesSummary {
        ...IssuesSummaryFragment
      }
    }
  }
}

```

### Variables

```json
{
  "id": "4",
  "mockOptions": MockDataInput
}

```

### Response

```json
{
  "data": {
    "wlanInterfaceConnection": {
      "node": WlanInterfaceConnection
    }
  }
}

```

## Related operations

- [`wlanInterface`](https://wartiva.com/api-docs/queries/wlan-interface.html) query: Retrieves a WlanInterface by its graph object id: a Wi-Fi adapter on a Windows, macOS, or Linux endpoint, with its radio and connection state.

---

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