Get VPS statistics

GET

/vps/{id}/stats

Usage of the VPS over one month: CPU, RAM, network and disk I/O, as measured by the hypervisor. Samples are oldest first; latest repeats the newest CPU and RAM values.

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/vps/12345/stats?month=2026-11' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Request successful",
    "data": {
        "month": "2026-11",
        "previous_month": "2026-10",
        "next_month": null,
        "units": {
            "cpu": "%",
            "ram": "MB",
            "net_in": "MB/s",
            "net_out": "MB/s",
            "disk_read": "MB/s",
            "disk_write": "MB/s"
        },
        "samples": [
            {
                "time": "2026-11-10T09:40:00+01:00",
                "cpu": 3.2,
                "ram": 812,
                "net_in": 0.0213,
                "net_out": 0.0087,
                "disk_read": 0,
                "disk_write": 0.0412
            }
        ],
        "latest": {
            "time": "2026-11-10T09:40:00+01:00",
            "cpu": 3.2,
            "ram": 812
        }
    }
}

🟠400month must be YYYY-MM

🟠400Invalid input

🟠400SSL connection is required

🟠400No valid VPS ID provided

🟠400No access to this VPS

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-11-13 09:40:27

Change VPS hostname

List VPS licenses