List all your VPS accounts

Get an overview of all your virtual servers (VPS), including IP address, status, resources, and bandwidth usage. This endpoint returns a unique ID needed for subsequent actions.

Headers

Accept Example

Content-Type Example

Responses

200

success boolean

timestamp string

requestId string

data object

GET https://cloud.hostup.se/api/vps-accounts

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/vps-accounts" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "vps_accounts": [
      {
        "id": "string",
        "name": "string",
        "ip": "string",
        "status": "string",
        "vmStatus": "string",
        "bandwidth": {
          "used": 0,
          "limit": 0,
          "inbound": 0,
          "outbound": 0
        },
        "proxmoxVmId": "string",
        "serverId": "string",
        "product_id": "string",
        "os": "string",
        "resources": {
          "cpu": 0,
          "ram": 0,
          "storage": 0
        },
        "price": 0,
        "billingCycle": "string",
        "currency": "string",
        "tags": [
          "string"
        ]
      }
    ],
    "pagination": {
      "currentPage": 0,
      "perPage": 0,
      "totalPages": 0,
      "totalRecords": 0
    }
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "vps_accounts": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "ip": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "vmStatus": {
                "type": "string"
              },
              "bandwidth": {
                "type": "object",
                "properties": {
                  "used": {
                    "type": "integer"
                  },
                  "limit": {
                    "type": "integer"
                  },
                  "inbound": {
                    "type": "integer"
                  },
                  "outbound": {
                    "type": "integer"
                  }
                }
              },
              "proxmoxVmId": {
                "type": "string"
              },
              "serverId": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "os": {
                "type": "string"
              },
              "resources": {
                "type": "object",
                "properties": {
                  "cpu": {
                    "type": "integer"
                  },
                  "ram": {
                    "type": "integer"
                  },
                  "storage": {
                    "type": "integer"
                  }
                }
              },
              "price": {
                "type": "integer"
              },
              "billingCycle": {
                "type": "string"
              },
              "currency": {
                "type": "string"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "pagination": {
          "type": "object",
          "properties": {
            "currentPage": {
              "type": "integer"
            },
            "perPage": {
              "type": "integer"
            },
            "totalPages": {
              "type": "integer"
            },
            "totalRecords": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}