Get and display firewall settings for a virtual server

View current firewall rules for your VPS/VM. Check if the firewall is enabled, review inbound and outbound policies, and examine IP filtering settings.

VPS Services Firewall

Context

Where to get IDs / values

path.vmid

GET /api/vps-accounts

Related endpoints

PUT /api/vm/{vmid}/firewall/options Manage firewall settings for your virtual server GET /api/vm/{vmid}/firewall View and manage firewall rules for a VPS POST /api/vm/{vmid}/firewall Manage firewall rules for VMs

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Responses

200

data object required

data.digest string · enum required · Example: c30b605a93d3259ac04248d0a863c6c8c2ddf732

c30b605a93d3259ac04248d0a863c6c8c2ddf732

cf0c74d651f2314ef799568eaa32dcc6542f4e07

e7183108a5b46c020b50af86b4321a648352be1b

data.enable integer required · Example: 1

data.ipfilter integer required · Example: 1

data.policy_in string · enum required · Example: DROP

ACCEPT

DROP

data.policy_out string · Example: ACCEPT

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}/firewall/options

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/vm/10000/firewall/options" \
  -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": {
    "digest": "c30b605a93d3259ac04248d0a863c6c8c2ddf732",
    "policy_out": "ACCEPT",
    "ipfilter": 1,
    "enable": 1,
    "policy_in": "DROP"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "digest": {
          "type": "string",
          "enum": [
            "c30b605a93d3259ac04248d0a863c6c8c2ddf732",
            "cf0c74d651f2314ef799568eaa32dcc6542f4e07",
            "e7183108a5b46c020b50af86b4321a648352be1b"
          ]
        },
        "enable": {
          "type": "integer"
        },
        "ipfilter": {
          "type": "integer"
        },
        "policy_in": {
          "type": "string",
          "enum": [
            "ACCEPT",
            "DROP"
          ]
        },
        "policy_out": {
          "type": "string"
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}