VPSBG's dev hub
HomePricingKnowledge BaseContact us
HomePricingKnowledge BaseContact us
  1. ISOs
  • šŸ‘‹ 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
    • 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
        GET
      • Delete an ISO
        DELETE
      • List ISOs
        GET
      • Add ISO
        POST
  1. ISOs

List ISOs

GET
https://api.vpsbg.eu/v1/isos
ISO
Retrieve a list of all ISO files, including their statuses and scheduled deletions.
⚠ Warning:
All ISO files are automatically deleted 48 hours after the download is completed.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
page
integerĀ 
optional
Which page of paginated results to return.
per_page
integerĀ 
optional
How many results to be displayed per page.
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 --request GET 'https://api.vpsbg.eu/v1/isos?page&per_page' \
--header 'Accept;'

Responses

🟢200List of ISO files
application/json
Body
data
array[objectĀ (ISO) {7}]Ā 
required
id
integerĀ 
required
status
stringĀ 
required
Can be: downloading, downloaded, deleted
Example:
downloaded
name
stringĀ 
required
Example:
AlmaLinux-9.5-x86_64-boot.iso
size
integerĀ 
required
The total file size in bytes. Represents the full size of the ISO/image being downloaded.
downloaded
integerĀ 
required
The number of bytes successfully downloaded so far. When this equals size, the download is complete.
created_at
stringĀ 
required
Example:
2025-02-03T10:58:19.000000Z
deletion_at
stringĀ 
required
All ISO files are automatically deleted after 48 hours of their creation.
links
objectĀ 
required
first
stringĀ 
required
last
stringĀ 
required
prev
nullĀ 
required
next
nullĀ 
required
meta
objectĀ 
required
current_page
integerĀ 
required
from
integerĀ 
required
last_page
integerĀ 
required
links
arrayĀ [object {3}]Ā 
required
path
stringĀ 
required
per_page
integerĀ 
required
to
integerĀ 
required
total
integerĀ 
required
Example
{
  "data": [
    {
      "id": 1,
      "status": "downloaded",
      "name": "AlmaLinux-9.5-x86_64-boot.iso",
      "size": 1111998464,
      "downloaded": 1111998464,
      "created_at": "2025-02-03T10:58:19.000000Z",
      "deletion_at": "2025-02-05T10:58:19.000000Z"
    }
  ],
  "links": {
    "first": "https://api.vpsbg.eu/v1/isos?page=1",
    "last": "https://api.vpsbg.eu/v1/isos?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "https://api.vpsbg.eu/v1/isos?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Next »",
        "active": false
      }
    ],
    "path": "https://api.vpsbg.eu/v1/isos",
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}
šŸ”“500Server Error
Previous
Delete an ISO
Next
Add ISO
Built with