---
title: "Returns a list with all the free vlans"
method: GET
path: "/vlans/free/"
tags: ["Vlans"]
---

# Returns a list with all the free vlans

`GET /vlans/free/`

## Response `200`

OK

- Vlan[]
  - `gateway` string
  - `ip_free` integer
  - `ip_range` string
  - `netmask` string
  - `vlan_id` integer

## Other responses

- `default` — Unexpected error

## Changes

- **2025-01-10** `114a2ed0a4a3` — 1 info
  - endpoint added
- **2024-01-29** `73b6d82124fb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/quadsproject/apis/quads/changes/vlans/free/get.md)

---

[API](https://skmtc.dev/quadsproject/apis/quads.md) · [All operations](https://skmtc.dev/quadsproject/apis/quads/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quadsproject/quads/revisions/a060ee3d649d/schema)
