Get and display network information for a specific VM

View detailed network configuration for a virtual machine (VM), including its IP addresses, MAC addresses, and VLAN tags. This is useful when you need to troubleshoot network connections or verify network settings for your server.

VPS Services Networking

Context

Where to get IDs / values

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.allowedIPv4Blocks array<string> required · Example: ["806","816"]
data.allowedIPv6Blocks array<string> required · Example: ["807","805"]
data.availableIPv4 array<object> required · Example: [{"id":"11709","ipaddress":"192.0.0.1","server_id":"816","vlan":"104","status":"assigne...
data.availableIPv4[].allocationStatus string · enum required · Example: assigned_to_current
assigned_to_current
assigned_to_other
data.availableIPv4[].description string required · Example: account #100005
data.availableIPv4[].id string required · Example: 11709
data.availableIPv4[].ipaddress string required · Example: 192.0.0.1
data.availableIPv4[].isAvailable boolean required · Example: false
data.availableIPv4[].revdns string required · Example: example.com
data.availableIPv4[].server_id string required · Example: 816
data.availableIPv4[].status string · enum required · Example: assigned_to_account
assigned_to_account
available
data.availableIPv4[].subnet_id string required · Example: 816
data.availableIPv4[].subnet_name string required · Example: 192.0.0.1/25
data.availableIPv4[].vlan string required · Example: 104
data.availableIPv6 array<object> required · Example: [{"id":"11293","ipaddress":"2001:db8::1","server_id":"812","vlan":"104","status":"avail...
data.availableIPv6[].allocationStatus string required · Example: assigned_to_other
data.availableIPv6[].description string required · Example: account #100006
data.availableIPv6[].id string required · Example: 11293
data.availableIPv6[].ipaddress string required · Example: 2001:db8::1
data.availableIPv6[].isAvailable boolean required · Example: false
data.availableIPv6[].revdns string required · Example:
data.availableIPv6[].server_id string required · Example: 812
data.availableIPv6[].status string required · Example: available
data.availableIPv6[].subnet_id string required · Example: 812
data.availableIPv6[].subnet_name string required · Example: 2001:db8::1/56
data.availableIPv6[].vlan string required · Example: 104
data.interfaces array<object> required · Example: [{"id":"net0","name":"net0","model":"virtio","mac":"00:00:00:00:00:00","firewall":"1","...
data.interfaces[].bridge string required · Example: vmbr0
data.interfaces[].firewall string required · Example: 1
data.interfaces[].id string required · Example: net0
data.interfaces[].ip array<object> required · Example: [{"id":11709,"vmid":10000,"interface":0,"ipaddress":"192.0.0.1","mac":"00:00:00:00:00:0...
data.interfaces[].ip[].gateway string · enum required · Example: 192.0.0.1
10.0.0.0
2001:db8::1
192.0.0.1
192.0.0.1
data.interfaces[].ip[].id integer required · Example: 11709
data.interfaces[].ip[].interface integer required · Example: 0
data.interfaces[].ip[].ip string required · Example: 192.0.0.1
data.interfaces[].ip[].ipaddress string required · Example: 192.0.0.1
data.interfaces[].ip[].mac string · enum required · Example: 00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
data.interfaces[].ip[].main integer required · Example: 1
data.interfaces[].ip[].mask string required · Example: /25
data.interfaces[].ip[].network string · enum required · Example: 192.0.0.1/25
10.0.0.0/24
2001:db8::1/56
192.0.0.1/25
192.0.0.1/25
data.interfaces[].ip[].options object required
data.interfaces[].ip[].options.keep_mac boolean required · Example: false
data.interfaces[].ip[].options.private boolean required · Example: false
data.interfaces[].ip[].private string required · Example: 0
data.interfaces[].ip[].revdns string required · Example: example.com
data.interfaces[].ip[].server_id integer required · Example: 816
data.interfaces[].ip[].type string · enum required · Example: ipv4
ipv4
ipv6
data.interfaces[].ip[].vlan string required · Example: 104
data.interfaces[].ip[].vmid integer required · Example: 10000
data.interfaces[].ip[].wanip string required · Example:
data.interfaces[].link_down string required · Example:
data.interfaces[].mac string · enum required · Example: 00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
00:00:00:00:00:00
data.interfaces[].model string required · Example: virtio
data.interfaces[].name string required · Example: net0
data.interfaces[].vlan string | boolean required · Example: 104
data.ipChangePolicy object required
data.ipChangePolicy.lastUsedAt string · nullable required · Example: null

Nullable: may be null when not applicable.

data.ipChangePolicy.monthlyLimit integer required · Example: 2
data.ipChangePolicy.nextReset string required · Example: 2026-02-10T00:00:00.000Z
data.ipChangePolicy.periodStart string required · Example: 2026-02-10T00:00:00.000Z
data.ipChangePolicy.remaining integer required · Example: 2
data.ipChangePolicy.usedThisPeriod integer required · Example: 0
data.ipv4Limit integer required · Example: 1
data.ipv6Limit integer required · Example: 0
data.ipv6UpgradeOption object required
data.ipv6UpgradeOption.configId string required · Example: 4787
data.ipv6UpgradeOption.currentValue integer required · Example: 0
data.ipv6UpgradeOption.max integer required · Example: 1
data.ipv6UpgradeOption.min integer required · Example: 0
data.ipv6UpgradeOption.monthlyPrice integer required · Example: 0
data.ipv6UpgradeOption.name string required · Example: IPv6 Address
data.ipv6UpgradeOption.step integer required · Example: 1
data.ipv6UpgradeOption.variable string required · Example: iplimitv6
data.primaryIP string required · Example: 192.0.0.1
data.primaryIPrDNS string required · Example: example.com
data.privateNetworkDefaults object required
data.privateNetworkDefaults.rackId string required · Example: dc1r28
data.privateNetworkDefaults.vlanRange object required
data.privateNetworkDefaults.vlanRange.max integer required · Example: 399
data.privateNetworkDefaults.vlanRange.min integer required · Example: 200
data.privateNetworks array<object> required · Example: [{"allocationId":12,"parentCidr":"10.0.0.0/21","rackId":"dc1r28","status":"pending_swit...
data.privateNetworks[].allocationId integer required · Example: 12
data.privateNetworks[].parentCidr string required · Example: 10.0.0.0/21
data.privateNetworks[].rackId string required · Example: dc1r28
data.privateNetworks[].status string required · Example: pending_switch
data.privateNetworks[].subnets array<object> required · Example: [{"id":"853","cidr":"10.0.0.0/24","vlanId":220,"gateway":"10.0.0.0","status":"pending_s...
data.privateNetworks[].subnets[].allocationId integer required · Example: 12
data.privateNetworks[].subnets[].cidr string required · Example: 10.0.0.0/24
data.privateNetworks[].subnets[].gateway string required · Example: 10.0.0.0
data.privateNetworks[].subnets[].hostbill object required
data.privateNetworks[].subnets[].hostbill.assignedIps integer required · Example: 252
data.privateNetworks[].subnets[].hostbill.description string required · Example: Private subnet for client 13150 (VLAN 220)
data.privateNetworks[].subnets[].hostbill.name string required · Example: Test (10.0.0.0/24)
data.privateNetworks[].subnets[].hostbill.totalIps integer required · Example: 256
data.privateNetworks[].subnets[].id string required · Example: 853
data.privateNetworks[].subnets[].status string required · Example: pending_switch
data.privateNetworks[].subnets[].vlanId integer required · Example: 220
data.vlanTag string required · Example: 104
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/vm/{vmid}/network
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/network" \
  -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": {
    "interfaces": [
      {
        "id": "net0",
        "name": "net0",
        "model": "virtio",
        "mac": "00:00:00:00:00:00",
        "firewall": "1",
        "ip": [
          {
            "id": 11709,
            "vmid": 10000,
            "interface": 0,
            "ipaddress": "192.0.0.1",
            "mac": "00:00:00:00:00:00",
            "wanip": "",
            "ip": "192.0.0.1",
            "mask": "/25",
            "network": "192.0.0.1/25",
            "gateway": "192.0.0.1",
            "main": 1,
            "options": {
              "private": false,
              "keep_mac": false
            },
            "server_id": 816,
            "type": "ipv4",
            "vlan": "104",
            "private": "0",
            "revdns": "example.com"
          }
        ],
        "bridge": "vmbr0",
        "vlan": "104",
        "link_down": ""
      }
    ],
    "availableIPv4": [
      {
        "id": "11709",
        "ipaddress": "192.0.0.1",
        "server_id": "816",
        "vlan": "104",
        "status": "assigned_to_account",
        "allocationStatus": "assigned_to_current",
        "isAvailable": false,
        "subnet_id": "816",
        "subnet_name": "192.0.0.1/25",
        "description": "account #100005",
        "revdns": "example.com"
      }
    ],
    "availableIPv6": [
      {
        "id": "11293",
        "ipaddress": "2001:db8::1",
        "server_id": "812",
        "vlan": "104",
        "status": "available",
        "allocationStatus": "assigned_to_other",
        "isAvailable": false,
        "subnet_id": "812",
        "subnet_name": "2001:db8::1/56",
        "description": "account #100006",
        "revdns": ""
      },
      {
        "id": "11291",
        "ipaddress": "2001:db8::1",
        "server_id": "812",
        "vlan": "104",
        "status": "available",
        "allocationStatus": "assigned_to_other",
        "isAvailable": false,
        "subnet_id": "812",
        "subnet_name": "2001:db8::1/56",
        "description": "Subnet 2001:db8::1/64",
        "revdns": ""
      },
      {
        "_truncated": "... and 95 more items"
      }
    ],
    "ipv4Limit": 1,
    "ipv6Limit": 0,
    "primaryIP": "192.0.0.1",
    "primaryIPrDNS": "example.com",
    "vlanTag": "104",
    "allowedIPv4Blocks": [
      "806",
      "816",
      {
        "_truncated": "... and 7 more items"
      }
    ],
    "allowedIPv6Blocks": [
      "807",
      "805",
      {
        "_truncated": "... and 7 more items"
      }
    ],
    "ipv6UpgradeOption": {
      "configId": "4787",
      "name": "IPv6 Address",
      "variable": "iplimitv6",
      "min": 0,
      "max": 1,
      "step": 1,
      "monthlyPrice": 0,
      "currentValue": 0
    },
    "privateNetworks": [
      {
        "allocationId": 12,
        "parentCidr": "10.0.0.0/21",
        "rackId": "dc1r28",
        "status": "pending_switch",
        "subnets": [
          {
            "id": "853",
            "cidr": "10.0.0.0/24",
            "vlanId": 220,
            "gateway": "10.0.0.0",
            "status": "pending_switch",
            "allocationId": 12,
            "hostbill": {
              "name": "Test (10.0.0.0/24)",
              "description": "Private subnet for client 13150 (VLAN 220)",
              "assignedIps": 252,
              "totalIps": 256
            }
          }
        ]
      }
    ],
    "privateNetworkDefaults": {
      "rackId": "dc1r28",
      "vlanRange": {
        "min": 200,
        "max": 399
      }
    },
    "ipChangePolicy": {
      "monthlyLimit": 2,
      "usedThisPeriod": 0,
      "remaining": 2,
      "periodStart": "2026-02-10T00:00:00.000Z",
      "nextReset": "2026-02-10T00:00:00.000Z",
      "lastUsedAt": null
    }
  }
}