List ISOs

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

string

required

Default:

application/json

Responses

🟢200List of ISO files

application/json

Body

data

array[object (ISO) {7}]

required

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

null

required

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

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": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://api.vpsbg.eu/v1/isos?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Next &raquo;",
        "active": false
      }
    ],
    "path": "https://api.vpsbg.eu/v1/isos",
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}

🔴500Server Error

Request

Request samples

Responses