---
title: WlanInterface type | Wartiva GraphQL API
description: A wireless LAN (Wi-Fi) adapter on an Endpoint, collected from Windows, macOS, and Linux endpoints by the periodic Wi-Fi inventory.
url: https://wartiva.com/api-docs/types/wlan-interface.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `WlanInterface` type

A wireless LAN (Wi-Fi) adapter on an [Endpoint](https://wartiva.com/api-docs/types/endpoint.html), collected from Windows, macOS, and Linux endpoints by the periodic Wi-Fi inventory. It records the adapter's radio and connection state and maps to the general-purpose [Interface](https://wartiva.com/api-docs/types/interface.html) for the same adapter. Its current association is a [WlanInterfaceConnection](https://wartiva.com/api-docs/types/wlan-interface-connection.html), and the Wi-Fi networks its scans can see are [WlanNetwork](https://wartiva.com/api-docs/types/wlan-network.html) objects.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The WlanInterface's unique identifier on the security graph. |
| `orgId` - [`OrganizationId!`](https://wartiva.com/api-docs/types/organization-id.html) | Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to. |
| `seen` - [`SeenOnline!`](https://wartiva.com/api-docs/types/seen-online.html) | Describes when this WlanInterface was seen. |
| `objectType` - [`GraphObjectType!`](https://wartiva.com/api-docs/types/graph-object-type.html) | The type of this graph object. |
| `objectTypeLabel` - [`String!`](https://wartiva.com/api-docs/types/string.html) | A localized label describing the object type. |
| `displayName` - [`String!`](https://wartiva.com/api-docs/types/string.html) | A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object. |
| `firstSeen` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time this object was first seen. |
| `lastSeen` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time this object was last seen. |
| `createdAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was created in the security graph. |
| `updatedAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was last mutated in the security graph. |
| `snapshotInfo` - [`GraphObjectSnapshotInfo!`](https://wartiva.com/api-docs/types/graph-object-snapshot-info.html) | Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed. |
| `endpoint` - [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) | The Endpoint this WlanInterface belongs to if available. |
| `interface` - [`Interface`](https://wartiva.com/api-docs/types/interface.html) | The network interface on the endpoint that this Wireless LAN interface maps to if available. |
| `interfaceId` - [`String!`](https://wartiva.com/api-docs/types/string.html) | Unique Id of the Wireless LAN interface on an endpoint. MS Windows: win32 GUID for more info see [GUID structure (Microsoft)](https://learn.microsoft.com/en-us/windows/win32/api/guiddef/ns-guiddef-guid) macOS: BSD-style interface name. |
| `description` - [`String`](https://wartiva.com/api-docs/types/string.html) | O/S description of the interface on the endpoint if available. |
| `mac` - [`Mac`](https://wartiva.com/api-docs/types/mac.html) | The basic service set identifier (BSSID) of the endpoint Wireless LAN interface on the endpoint. The BSSID is usually the same as the Wlan interface Mac address. |
| `connectionState` - [`WlanInterfaceConnectionState`](https://wartiva.com/api-docs/types/wlan-interface-connection-state.html) | The connection state of the interface. |
| `radioState` - [`WlanInterfaceRadioState`](https://wartiva.com/api-docs/types/wlan-interface-radio-state.html) | The state of the wireless lan radio. |
| `connections` - [`WlanInterfaceConnectionConnection!`](https://wartiva.com/api-docs/types/wlan-interface-connection-connection.html) | Current connections on this Wireless LAN interface. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `connectionsSeen` - [`WlanInterfaceConnectionConnection!`](https://wartiva.com/api-docs/types/wlan-interface-connection-connection.html) | Historical sightings of [WlanInterfaceConnection](https://wartiva.com/api-docs/types/wlan-interface-connection.html) on this Wireless LAN interface. Each edge records when the connection was observed; pass timeRange to constrain the window. When timeRange is null the last 30 days will be returned. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. `timeRange` - [`DateTimeRangeInput`](https://wartiva.com/api-docs/types/date-time-range-input.html) Restrict edges to a date/time range. `includeSeen` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) Include the per-edge seen series in the response. |
| `availableNetworks` - [`WlanNetworkConnection!`](https://wartiva.com/api-docs/types/wlan-network-connection.html) | Wireless LAN networks currently visible from the interface. When timeRange is null the last 30 days will be returned. When timeRange is specified all entries seen in the time range are returned. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. `timeRange` - [`DateTimeRangeInput`](https://wartiva.com/api-docs/types/date-time-range-input.html) Optional time range filter. `includeSeen` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) When true, the payload will include information about when the edge was seen in the relationship. The data set will be limited to the time range specified in the timeRange field. If includeSeen is true and timeRange is null then seen data for the default 7 day time range will be returned. |
| `findings` - [`FindingsPayload!`](https://wartiva.com/api-docs/types/findings-payload.html) | Policy findings for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issues` - [`IssuesPayload!`](https://wartiva.com/api-docs/types/issues-payload.html) | Policy issues for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issuesSummary` - [`IssuesSummary!`](https://wartiva.com/api-docs/types/issues-summary.html) | Summary of the active policy issues currently open on this object, broken down by severity. |

## Returned by

- [`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.
- [`wlanInterfaceConnection`](https://wartiva.com/api-docs/queries/wlan-interface-connection.html) query: Retrieves a WlanInterfaceConnection by its graph object id: an endpoint Wi-Fi adapter's association with one network and access point, with its…

## 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.
- [`GraphObjectType`](https://wartiva.com/api-docs/types/graph-object-type.html) enum: An enumeration of the different types of security graph objects.
- [`GraphObjectTypeCategory`](https://wartiva.com/api-docs/types/graph-object-type-category.html) enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
- [`RuleApplyToOptionKey`](https://wartiva.com/api-docs/types/rule-apply-to-option-key.html) enum: Attribute keys that further scope which objects a rule applies to, in addition to its applyTo object type.
- [`WlanInterfaceConnection`](https://wartiva.com/api-docs/types/wlan-interface-connection.html) type: The association between an endpoint's WlanInterface and a Wi-Fi network, identified by the adapter, the network name (SSID), and the access point's…
- [`WlanInterfaceEdge`](https://wartiva.com/api-docs/types/wlan-interface-edge.html) type: Edge payload for a WlanInterface with optional seen data.
- [`WlanInterfaceList`](https://wartiva.com/api-docs/types/wlan-interface-list.html) type: Collection payload for WlanInterface edges with total count.
- [`WlanInterfacePayload`](https://wartiva.com/api-docs/types/wlan-interface-payload.html) type: Payload wrapper for a single WlanInterface result.

## Related types

- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
- [`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
{
  "id": "4",
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "endpoint": Endpoint,
  "interface": Interface,
  "interfaceId": "abc123",
  "description": "abc123",
  "mac": "f0:18:98:14:8e:80",
  "connectionState": "NOT_READY",
  "radioState": "ON",
  "connections": WlanInterfaceConnectionConnection,
  "connectionsSeen": WlanInterfaceConnectionConnection,
  "availableNetworks": WlanNetworkConnection,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}

```

---

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