API Documentation

Public REST API for querying x86_64 qcow2 Linux cloud images. No authentication required for read endpoints.

Tracked Distributions

Distro	Versions	Source
Fedora	43, 44	fedoraproject.org/releases.json
Ubuntu	24.04, 26.04	cloud-images.ubuntu.com
Debian	12, 13	cloud.debian.org
AlmaLinux	9, 10	repo.almalinux.org
Rocky Linux	9, 10	dl.rockylinux.org

Images are scanned daily at 04:00 UTC. Only x86_64 qcow2 (or .img) format.

GET/api/images

List all images

Query Parameters

distro(string)Filter by distro: fedora, ubuntu, debian, almalinux, rocky

version(string)Filter by version: 44, 24.04, 13, 9, etc.

latest(boolean)Only return the latest release per distro+version

Example

curl /api/images?distro=ubuntu&latest=true

Response

{
  "images": [
    {
      "id": "...",
      "distro": "ubuntu",
      "version": "24.04",
      "arch": "x86_64",
      "release_id": "release-20260518",
      "filename": "ubuntu-24.04-server-cloudimg-amd64.img",
      "download_url": "https://cloud-images.ubuntu.com/...",
      "checksum_algo": "sha256",
      "checksum": "53fdde89...",
      "file_size": null,
      "is_latest": true,
      "source": "scanner",
      "enabled": true,
      "discovered_at": "2026-06-02T03:20:28Z",
      "created_at": "2026-06-02T03:20:28Z"
    }
  ],
  "count": 1
}

GET/api/images/:id

Get a single image by ID

Example

curl /api/images/{id}

Response

{
  "id": "...",
  "distro": "fedora",
  "version": "44",
  ...
}

Quick Examples

Get all latest images:

curl /api/images?latest=true

Get latest Fedora images only:

curl /api/images?distro=fedora&latest=true

Get all Rocky Linux 9 releases:

curl /api/images?distro=rocky&version=9