List your private networks and subnets

Retrieve an overview of your private networks and their configurations, including subnetId and vlanId for network settings.

VPS Services VM

Context

Workflow links

Produces

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.defaults object required
data.defaults.childMask integer required · Example: 24
data.defaults.parentMask integer required · Example: 21
data.defaults.rackId string required · Example: dc1r28
data.defaults.superblock string required · Example: 10.0.0.0/14
data.defaults.vlanRange object required
data.defaults.vlanRange.max integer required · Example: 399
data.defaults.vlanRange.min integer required · Example: 200
data.limits object required
data.limits.privateNetworks object required
data.limits.privateNetworks.approvedLimit string · nullable required · Example: null

Nullable: may be null when not applicable.

data.limits.privateNetworks.available integer required · Example: 0
data.limits.privateNetworks.limit integer required · Example: 1
data.limits.privateNetworks.pendingRequest string · nullable required · Example: null

Nullable: may be null when not applicable.

data.limits.privateNetworks.used integer required · Example: 1
data.networks array<object> required · Example: [{"id":24,"parentSubnetId":"893","parentCidr":"10.0.0.0/21","rackId":"dc1r28","status":...
data.networks[].id integer required · Example: 24
data.networks[].metadata object required
data.networks[].metadata.requestedBy string required · Example: 13887
data.networks[].parentCidr string required · Example: 10.0.0.0/21
data.networks[].parentSubnetId string required · Example: 893
data.networks[].rackId string required · Example: dc1r28
data.networks[].status string required · Example: pending_switch
data.networks[].subnets array<object> required · Example: [{"id":34,"subnetId":"894","cidr":"10.0.0.0/24","vlanId":233,"gateway":"10.0.0.0","stat...
data.networks[].subnets[].cidr string required · Example: 10.0.0.0/24
data.networks[].subnets[].gateway string · enum required · Example: 10.0.0.0
10.0.0.0
10.0.0.0
data.networks[].subnets[].hostbill object required
data.networks[].subnets[].hostbill.assignedIps integer required · Example: 0
data.networks[].subnets[].hostbill.description string required · Example: test
data.networks[].subnets[].hostbill.name string required · Example: Test (10.0.0.0/24)
data.networks[].subnets[].hostbill.reservedIps integer required · Example: 5
data.networks[].subnets[].hostbill.totalIps integer required · Example: 256
data.networks[].subnets[].id integer required · Example: 34
data.networks[].subnets[].status string required · Example: pending_switch
data.networks[].subnets[].subnetId string required · Example: 894
data.networks[].subnets[].vlanId integer required · Example: 233
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/private-networks
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/private-networks" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "networks": [
      {
        "id": 24,
        "parentSubnetId": "893",
        "parentCidr": "10.0.0.0/21",
        "rackId": "dc1r28",
        "status": "pending_switch",
        "metadata": {
          "requestedBy": "13887"
        },
        "subnets": [
          {
            "id": 34,
            "subnetId": "894",
            "cidr": "10.0.0.0/24",
            "vlanId": 233,
            "gateway": "10.0.0.0",
            "status": "pending_switch",
            "hostbill": {
              "name": "Test (10.0.0.0/24)",
              "description": "test",
              "assignedIps": 0,
              "reservedIps": 5,
              "totalIps": 256
            }
          }
        ]
      }
    ],
    "defaults": {
      "rackId": "dc1r28",
      "vlanRange": {
        "min": 200,
        "max": 399
      },
      "superblock": "10.0.0.0/14",
      "parentMask": 21,
      "childMask": 24
    },
    "limits": {
      "privateNetworks": {
        "limit": 1,
        "used": 1,
        "available": 0,
        "approvedLimit": null,
        "pendingRequest": null
      }
    }
  }
}