Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Networks

List subnets

Returns a list of subnets. Use the owned_by query parameter to control which subnets are returned: project (default) returns only subnets owned by the project, any returns all subnets from networks available to the project.

get/cloud/v1/subnets/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

Query parameters

limitinteger

Optional. Limit the number of returned items

Example:1000

Optional. Limit the number of returned items

network_idstring uuid4

Only list subnets of this network

Example:b30d0de7-bca2-4c83-9c57-9e645bd2cc92

Only list subnets of this network

offsetinteger

Optional. Offset value is used to exclude the first set of records from the result

Optional. Offset value is used to exclude the first set of records from the result

order_by'available_ips.asc' | 'available_ips.desc' | 'cidr.asc' | 'cidr.desc' | 'created_at.asc' | 'created_at.desc' | 'name.asc' | 'name.desc' | 'total_ips.asc' | 'total_ips.desc' | 'updated_at.asc' | 'updated_at.desc'

Ordering subnets list result by name, created_at, updated_at, available_ips, total_ips, and cidr (default) fields of the subnet and directions (name.asc).

owned_by'any' | 'project'

Controls which subnets are returned. 'project' (default) returns only subnets owned by the project. 'any' returns all subnets from networks available to the project, including subnets from shared networks.

tag_keystring[]

Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

[
  "key1",
  "key2"
]
tag_key_valuestring

Optional. Filter by tag key-value pairs.

Optional. Filter by tag key-value pairs.

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "available_ips": 250,
      "cidr": "192.168.13.0/24",
      "created_at": "2019-06-13T13:58:12+0000",
      "creator_task_id": "5cc890da-d031-4a23-ac31-625edfa22812",
      "dns_nameservers": [
        "8.8.8.8",
        "8.8.4.4"
      ],
      "enable_dhcp": true,
      "gateway_ip": "192.168.13.1",
      "host_routes": [],
      "id": "b39792c3-3160-4356-912e-ba396c95cdcf",
      "name": "subnet_3",
      "network_id": "b30d0de7-bca2-4c83-9c57-9e645bd2cc92",
      "project_id": 1337,
      "region": "Luxembourg 1",
      "region_id": 7,
      "tags": [
        {
          "key": "my-tag",
          "read_only": false,
          "value": "my-tag-value"
        }
      ],
      "total_ips": 253,
      "updated_at": "2019-06-13T13:58:12+0000"
    }
  ]
}