---
title: "Get device VLAN"
method: GET
path: "/v1/device/{device_id}/vlan/{vlan_id}"
tags: ["Devices"]
---

# Get device VLAN

`GET /v1/device/{device_id}/vlan/{vlan_id}`

Get a specific virtual interface (VLAN) for a device.

## Path parameters

- `device_id` string, required — ID of a device
- `vlan_id` string, required — The ID of the VLAN

## Response `200`

OK

- DeviceVLAN — Device virtual interface (VLAN) configuration
  - `gateway` string, ipv4 — Gateway IP address. Required when network_mode is "static".
  - `ip_address` string — IP address and network mask in CIDR notation (e.g., "192.168.100.1/24"). Required when network_mode is "static".
  - `name` string, required — Display name for the virtual interface
  - `network_mode` 'dhcp' | 'static', required — Network mode (DHCP or static IP)
  - `network_update_pending` boolean — Returned in response only, to indicate that the network update is in progress.
  - `vlan_id` string, required — Unique identifier for the VLAN
  - `vlan_tag` integer, required — 802.1Q VLAN tag (1-4094)

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/slide/apis/slide-api.md) · [All operations](https://skmtc.net/slide/apis/slide-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slide/slide-api/revisions/c63e4b604dd1/schema)