List and query images.

Documents & examples

Method: GET

URL: /rest_api/v1/images/

Query params:

  • arch (string)
  • bootable (bool)
  • compose (string)
  • disc_count (int)
  • disc_number (int)
  • file_name (string)
  • image_format (string)
  • image_type (string)
  • implant_md5 (string)
  • md5 (string)
  • mtime (int)
  • sha1 (string)
  • sha256 (string)
  • size (int)
  • subvariant (string)
  • volume_id (string)
  • ordering (string) Comma separated list of fields for ordering results.
    • To sort by a field in descending order, prefix its name with minus (e.g. -name).
    • Use double underscores for nested field names (e.g. parent__child for {"parent": {"child": ...}}).

Following filters can be used to show only specific fields. This can make response time faster. Format is list or single value (JSON: {"fields": ["a","b"]} or {"fields": "a"}, in URL: ?fields=a&fields=b).

  • fields (list | string) Fields to display (other fields will be hidden).
  • exclude_fields: (list | string) Fields NOT to display (overrules fields).

The compose filter allows filtering images connected to a particular compose. The value should be compose ID.

If the same filter is specified multiple times, it will do a OR query.

Response: a paged list of following objects

{
    "arch": "string", 
    "bootable (optional, default=false)": "boolean", 
    "composes (read-only)": [
        "compose_id"
    ], 
    "disc_count": "int", 
    "disc_number": "int", 
    "file_name": "string", 
    "image_format": "ImageFormat.name", 
    "image_type": "ImageType.name", 
    "implant_md5 (optional, default=null, nullable)": "string", 
    "md5 (optional, default=null, nullable)": "string", 
    "mtime": "int", 
    "sha1 (optional, default=null, nullable)": "string", 
    "sha256": "string", 
    "size": "int", 
    "subvariant (optional, default=\"\")": "string", 
    "volume_id (optional, default=null, nullable)": "string"
}

Browsable GET

GET /rest_api/v1/images/?page=13289
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "count": 276218,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=13290",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=13288",
    "results": [
        {
            "file_name": "Fedora-LXDE-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708773218,
            "size": 1709725696,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1760d0f854dd24b6b79006dd41ac8b0f7cf182847332ae33e1f569f730b27682",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "LXDE"
        },
        {
            "file_name": "Fedora-Budgie-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708773020,
            "size": 2118676480,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "339fdab850e36ef48af8674e8fdcb1983df6587d48569bb1c6b8721a5086f5e6",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Budgie"
        },
        {
            "file_name": "Fedora-Cinnamon-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708774144,
            "size": 2514980864,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "dd5688e3512317c9108daf057548f68d91f893d0ef398789cce065a251997085",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Cinnamon"
        },
        {
            "file_name": "Fedora-Sway-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708773169,
            "size": 1623625728,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "0bf63aa6d15845bff66f521567e0efac821b5d288e2af2cf5925fa880cc83292",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Sway"
        },
        {
            "file_name": "Fedora-Xfce-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708773400,
            "size": 1858725888,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "176e8c9f4571b755bb887e764d9304ba75a77ad4a1d60a2636e226b6924a0c5a",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Xfce"
        },
        {
            "file_name": "Fedora-SoaS-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708772861,
            "size": 1422966784,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "5c4f3a698275279c8ed06de0df076e2d05799f263349710548b7243b47922e28",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "SoaS"
        },
        {
            "file_name": "Fedora-KDE-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708773676,
            "size": 2629115904,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "17d7916aff2ee1ad0535bf6d2417fcf1144a350766efee85f076b673ab4a4ceb",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "KDE"
        },
        {
            "file_name": "Fedora-Workstation-Live-osb-40-20240224.n.0.aarch64.iso",
            "image_format": "iso",
            "image_type": "live-osbuild",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708774672,
            "size": 2576658432,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "49ffa40e58232ecec8fed990b9f1b7fae02054820c8a21b8f2e7b3e4c7db67ca",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-40-20240224.n.0.aarch64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708775416,
            "size": 2596498028,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "644166befa5c63c450d82a37d2c892824ef2c499a94c67fb74f7001db2244baf",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-aarch64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708773630,
            "size": 2242179072,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "b6cf7d0e66ac584b531ec644a30656bd3ddb681d1e028b941c4d6955929f31b6",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-osb-40-20240224.n.0.x86_64.iso",
            "image_format": "iso",
            "image_type": "live-osbuild",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708775185,
            "size": 2623733760,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "139bb11ed03bf8aedab4e7354973179a01940ee2da44c18306a80a161f3a2e62",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-x86_64-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708774253,
            "size": 2275708928,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "0d92f9d99a4eec39dacfe433470e86c23e0bf1eb719050e975b2f128eac25e83",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-ppc64le-40-20240224.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1708774673,
            "size": 2204217344,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1818dcedbc532b3fe212b06b77c44cb050c8bacf5b731e06d9e71524a6ab2e5f",
            "composes": [
                "Fedora-40-20240224.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20240224.n.1.aarch64.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708808410,
            "size": 632684544,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "47254d454ddd7d051fd7c7bc06b0a5b20cb72c6cf09950ebb45f2c8d42533f2b",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Azure-Rawhide-20240224.n.1.aarch64.vhd",
            "image_format": "vhd",
            "image_type": "vpc",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708808009,
            "size": 1323638784,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "70139d2e11ca2a8cbfc690ba2236522c1c53b7c8f0082ed7a2370856d4d9bcb8",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20240224.n.1.aarch64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1708808422,
            "size": 515037400,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "92235fc60bbd73292618d2f1226a14c5729111fcfa5691cac939c34f904ed619",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20240224.n.1.x86_64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708807685,
            "size": 511071176,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "0ecde8f655c1e9346743dfe93c0f66c8d66ae65e18bada3c4082f04eff4b9f43",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Vagrant-Rawhide-20240224.n.1.x86_64.vagrant-libvirt.box",
            "image_format": "vagrant-libvirt.box",
            "image_type": "vagrant-libvirt",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708808218,
            "size": 609743402,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "349896c5733465f6c746e2d2a46bece002465f8127aaa3969195f889e6097844",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20240224.n.1.x86_64.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708807675,
            "size": 618004480,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "e85cc5d35bb9db5423863d8ec85b5992d194d08f8e09b4611f8657523a0e4766",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-GCP-Rawhide-20240224.n.1.x86_64.tar.gz",
            "image_format": "tar.gz",
            "image_type": "tar-gz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1708807651,
            "size": 623190463,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "f7fcdf1259d7523b71f04ad01dd5ccf7e003a7d7c8bd73690d68a95614f82d90",
            "composes": [
                "Fedora-Rawhide-20240224.n.1"
            ],
            "subvariant": "Cloud_Base"
        }
    ]
}