VPSBG's dev hub
HomePricingKnowledge BaseContact us
HomePricingKnowledge BaseContact us
  1. Server Images
  • 👋 Hello
  • API Introduction
    • API Introduction
    • How to generate API key?
  • API Reference
    • User
      • 2FA
        • Get 2FA secret key
        • Enable 2FA
        • Disable 2FA
      • Update user
      • Get account information
    • Balance
      • Balance
      • Deposit funds
      • List balance transactions
    • Affiliate
      • Get affiliate information
      • List conversions
      • List payouts
      • Activate affiliate program
      • Update referral code
    • Invoices
      • List invoices
      • Download an invoice
      • Download invoices
    • Support
      • Tickets
        • List tickets
        • List departments
        • List related services
        • Get a ticket
        • Create new ticket
        • Reply to ticket
        • Mark ticket as resolved
        • Download attachment
      • List plans
      • Purchase support plan
      • Renew support plan
      • Cancel support plan
      • Undo cancel request
    • SSH Keys
      • Get an SSH Key
      • Update SSH Key
      • Delete SSH Key
      • List SSH keys
      • Add SSH Key
    • Servers
      • Scale
        • List plans
        • Calculate scale cost
        • Scale a server
      • Addons
        • List available addons
        • Scale addons
        • Calculate scale cost
        • Purchase new addons
        • Cancel addon
        • Undo cancel request
      • Rescue
        • Enable rescue mode
        • Disable rescue mode
      • List plans
      • List servers
      • Server status
      • Get a server
      • Server metrics
      • Bandwidth
      • Deploy new server
      • Start a server
      • Restart a server
      • Stop a server
      • Power off
      • Cancel server
      • Undo cancel request
      • Change password
      • Update hostname
      • Update SSH Keys
      • Modify ISOs
      • Restore
      • Renew server
      • Reinstall Server
      • Change Primary IP
      • Calculate renew amount
    • Plans
      • Plan addon
      • Plan promo-codes
    • Snapshots
      • List snapshots
      • Delete snapshot
    • Backups
      • List backups
      • Delete backup
    • Server Images
      • List server images
        GET
    • Floating IPs
      • List Floating IPs
      • Plans
      • Purchase Floating IPs
      • Attach Floating IP
      • Detach Floating IP
      • Cancel Floating IP
      • Delete Floating IP Cancellation
    • IP Addresses
      • Update IP address
    • Network Protection
      • Geo filter
        • Get current geo filter
        • Set geo filter
        • Update geo filter
        • Delete geo filter
      • Whitelist
        • Get status and list of IPs
        • Whitelist IP addresses
        • Update IP addresses list
        • Delete all rules
      • Blacklist
        • Get status and list of IPs
        • Blacklist IP addresses
        • Update IP addresses list
        • Delete all rules
      • General information
      • Bandwidth
      • List blocked IPs
      • List attacks
      • Get an attack
      • Attack bandwidth
    • Orders
      • List orders
      • Get an order
      • Delete order
      • Pay orders
      • Update order
      • Change renewal period
    • ISOs
      • Get an ISO
      • Delete an ISO
      • List ISOs
      • Add ISO
  1. Server Images

List server images

GET
/server-images
Server Images
List all server images (operating system or app templates) that can be used for deploying new server.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
filter[type]
string 
optional
Filter by server images type. Possible values: os, app
filter[group]
string 
optional
Filter by server images group. Example value: Ubuntu
filter[virtualization]
string 
optional
Filter by virtualization. Possible values: kvm, vzo
Default:
kvm
Header Params
Accept
string 
required
Default:
application/json

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.vpsbg.eu/v1/server-images?filter[type]&filter[group]&filter[virtualization]' \
--header 'Accept;' \
--header 'Content-Type: text/plain' \
--data-raw ''

Responses

🟢200List of available server images
application/json
Body
data
array[object (Server Image) {6}] 
optional
id
integer 
optional
name
string 
optional
minimum_ram
integer 
optional
Default:
1
Example:
1
eol
boolean 
optional
Default:
false
ssh_keys_support
boolean 
optional
Default:
false
group
object 
optional
links
object 
optional
first
string 
optional
last
string 
optional
prev
null 
optional
next
string 
optional
meta
object 
optional
current_page
integer 
optional
from
integer 
optional
last_page
integer 
optional
links
array [object {3}] 
optional
path
string 
optional
per_page
integer 
optional
to
integer 
optional
total
integer 
optional
Example
{
  "data": [
    {
      "id": 3,
      "name": "CentOS 7",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "CentOS",
        "type": "os",
        "key": "centos"
      }
    },
    {
      "id": 4,
      "name": "CentOS 7 Minimal",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "CentOS",
        "type": "os",
        "key": "centos"
      }
    },
    {
      "id": 8,
      "name": "Debian 9 Minimal",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 9,
      "name": "Fedora 23",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Fedora",
        "type": "os",
        "key": "fedora"
      }
    },
    {
      "id": 12,
      "name": "Ubuntu 16.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 14,
      "name": "CentOS 7",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "CentOS",
        "type": "os",
        "key": "centos"
      }
    },
    {
      "id": 16,
      "name": "Debian 9",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 19,
      "name": "Ubuntu 18.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 21,
      "name": "Windows Server 2016",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    },
    {
      "id": 22,
      "name": "Windows Server 2019",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    },
    {
      "id": 26,
      "name": "Debian 9",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 29,
      "name": "Ubuntu 18.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 31,
      "name": "Windows Server 2016",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    },
    {
      "id": 32,
      "name": "Windows Server 2019",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    },
    {
      "id": 35,
      "name": "Debian 10",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 36,
      "name": "Debian 10",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 37,
      "name": "Ubuntu 20.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 38,
      "name": "Ubuntu 20.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 39,
      "name": "Fedora 32",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Fedora",
        "type": "os",
        "key": "fedora"
      }
    },
    {
      "id": 40,
      "name": "Fedora 32",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Fedora",
        "type": "os",
        "key": "fedora"
      }
    },
    {
      "id": 41,
      "name": "CentOS 7 Minimal",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "CentOS",
        "type": "os",
        "key": "centos"
      }
    },
    {
      "id": 42,
      "name": "CentOS 7",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "CentOS",
        "type": "os",
        "key": "centos"
      }
    },
    {
      "id": 45,
      "name": "Debian 9",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 46,
      "name": "Debian 10",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 50,
      "name": "Ubuntu 18.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 51,
      "name": "Ubuntu 20.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 52,
      "name": "AlmaLinux 8.7",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "AlmaLinux",
        "type": "os",
        "key": "almalinux"
      }
    },
    {
      "id": 53,
      "name": "AlmaLinux 8.7",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "AlmaLinux",
        "type": "os",
        "key": "almalinux"
      }
    },
    {
      "id": 54,
      "name": "Debian 11",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 55,
      "name": "Debian 11",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 56,
      "name": "OpenSUSE 13.1",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 57,
      "name": "OpenSUSE 13.1",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 58,
      "name": "OpenSUSE 15.1",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 59,
      "name": "OpenSUSE 15.1",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 60,
      "name": "Fedora 34",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Fedora",
        "type": "os",
        "key": "fedora"
      }
    },
    {
      "id": 61,
      "name": "Fedora 34",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Fedora",
        "type": "os",
        "key": "fedora"
      }
    },
    {
      "id": 62,
      "name": "RockyLinux 8.6",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "RockyLinux",
        "type": "os",
        "key": "rockylinux"
      }
    },
    {
      "id": 63,
      "name": "RockyLinux 8.6",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "RockyLinux",
        "type": "os",
        "key": "rockylinux"
      }
    },
    {
      "id": 64,
      "name": "Debian 11",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Debian",
        "type": "os",
        "key": "debian"
      }
    },
    {
      "id": 65,
      "name": "WireGuard VPN",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "WireGuard VPN",
        "type": "app",
        "key": "wireguard"
      }
    },
    {
      "id": 66,
      "name": "SoftEther VPN",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "LEMP",
        "type": "app",
        "key": "lemp"
      }
    },
    {
      "id": 67,
      "name": "OpenVPN VPN",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 68,
      "name": "L2TP VPN",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "OpenSUSE",
        "type": "os",
        "key": "opensuse"
      }
    },
    {
      "id": 69,
      "name": "AlmaLinux 9.2",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "AlmaLinux",
        "type": "os",
        "key": "almalinux"
      }
    },
    {
      "id": 70,
      "name": "AlmaLinux 9.2",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "AlmaLinux",
        "type": "os",
        "key": "almalinux"
      }
    },
    {
      "id": 71,
      "name": "AlmaLinux 8",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "AlmaLinux",
        "type": "os",
        "key": "almalinux"
      }
    },
    {
      "id": 72,
      "name": "Ubuntu 22.04",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 73,
      "name": "Ubuntu 22.04",
      "minimum_ram": 1,
      "eol": true,
      "ssh_keys_support": false,
      "group": {
        "name": "Ubuntu",
        "type": "os",
        "key": "ubuntu"
      }
    },
    {
      "id": 74,
      "name": "Windows Server 2022",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    },
    {
      "id": 75,
      "name": "Windows Server 2022",
      "minimum_ram": 1,
      "eol": false,
      "ssh_keys_support": false,
      "group": {
        "name": "Windows Server",
        "type": "os",
        "key": "windows"
      }
    }
  ],
  "links": {
    "first": "https://api.vpsbg.eu/v1/server-images?page=1",
    "last": "https://api.vpsbg.eu/v1/server-images?page=2",
    "prev": null,
    "next": "https://api.vpsbg.eu/v1/server-images?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 2,
    "links": [
      {
        "url": null,
        "label": "pagination.previous",
        "active": false
      },
      {
        "url": "https://api.vpsbg.eu/v1/server-images?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://api.vpsbg.eu/v1/server-images?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": "https://api.vpsbg.eu/v1/server-images?page=2",
        "label": "pagination.next",
        "active": false
      }
    ],
    "path": "https://api.vpsbg.eu/v1/server-images",
    "per_page": 50,
    "to": 50,
    "total": 51
  }
}
🔴500Server Error
Modified at 2025-04-08 11:02:14
Previous
Delete backup
Next
List Floating IPs
Built with