---
title: "List subnets"
method: GET
path: "/v2.0/subnets"
tags: ["Subnets"]
---

# List subnets

`GET /v2.0/subnets`

Lists subnets to which the project has access.

## Query parameters

- `network_id` string
- `id` string
- `name` string
- `project_id` string
- `tenant_id` string
- `fields` string
- `sort_dir` 'asc' | 'desc'
- `sort_key` string
- `tags` string
- `tags-any` string
- `not-tags` string
- `not-tags-any` string

## Response `200`

Successful operation

- SubnetsResponse
  - `subnets` Subnet[]
    - `id` string, uuid
    - `name` string
    - `description` string
    - `network_id` string, uuid
    - `ip_version` 4 | 6
    - `cidr` string
    - `gateway_ip` string
    - `dhcp_enabled` boolean
    - `dns_nameservers` string[]
    - `allocation_pools` AllocationPool[]
      - `start` string
      - `end` string
    - `host_routes` HostRoute[]
      - `destination` string
      - `nexthop` string
    - `project_id` string, uuid
    - `tenant_id` string, uuid
    - `ipv6_address_mode` 'slaac' | 'dhcpv6-stateful' | 'dhcpv6-stateless'
    - `ipv6_ra_mode` 'slaac' | 'dhcpv6-stateful' | 'dhcpv6-stateless'
    - `subnetpool_id` string, uuid
    - `tags` string[]
    - `revision_number` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Missing or invalid JWT token.

---

[API](https://skmtc.net/platform9/apis/cluster-blueprint-api.md) · [All operations](https://skmtc.net/platform9/apis/cluster-blueprint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/platform9/cluster-blueprint-api/versions/708ad90fe444/schema)