List available OS images

GET

/vps/images

List available OS images for VPS order and reinstall. Use an id as image_id on POST /vps/order or POST /vps/{id}/reinstall. slug is the configure-page compatibility key used by GET /vps/products (extra_software.compatible_images).

Request

Authorization

API Key

Add parameter in header

API-key

Example:

API-key: ********************

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/images' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Request successful",
    "data": {
        "images": [
            {
                "id": 1,
                "name": "Ubuntu 22.04",
                "platform": "Linux",
                "slug": "ubuntu"
            }
        ]
    }
}

🟠400Wrong request method

🟠400SSL connection is required

🟠401No valid API key set

🟠401API key has expired

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

🔴500Error

Modified at 2026-09-01 15:18:31

Cancel VPS deletion

Reinstall VPS