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=12895
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "count": 278418,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=12896",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=12894",
    "results": [
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20231205.n.1.s390x.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701800287,
            "size": 471001996,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "60d21c79f06b251859a5f8aabc0b1c109deadf8881557d213c4b9bafe510c6af",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20231205.n.1.ppc64le.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701806038,
            "size": 585367552,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "d2c044a16c3eb54cfe6942fe67d9ba7bb7dfaeea7c901638ec446b90a53738e5",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Rawhide-20231205.n.1.ppc64le.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701806048,
            "size": 402724660,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "d35811fb0268069526b7f766bc48619f113f48ecd0432464c29d1043b0a16234",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Container-Base-Rawhide-20231205.n.1.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701800168,
            "size": 40362844,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "7e75fb6b88b6b0ef46948eeb879bd223e3860fdf7e741812931f122e82bfd8fa",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-Rawhide-20231205.n.1.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701800242,
            "size": 24450052,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "c7dc7dc865a308a41dcc1e774d8e1d3d576984f12deb957708526aeb06b73108",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-Rawhide-20231205.n.1.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701800869,
            "size": 172313484,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "d0a5cd61168321110caef9ae2c128a0fb26854cd424378429093da0ef1c32886",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Toolbox-Rawhide-20231205.n.1.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701800276,
            "size": 195970224,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "7436563dd6b56f7f1fc0c4cd9b750d451b47fc011cffed3dffc3cfd21ba8881b",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Base-Rawhide-20231205.n.1.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701800144,
            "size": 42609876,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "f52527b2e0a010762a9d641a87b1b2f044ab88fac0bc267dba3360e71812a8e4",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-Rawhide-20231205.n.1.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701800253,
            "size": 26740668,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "c6f1bfc576160cc757df23518e8cb6c90afa8fde41aaa58014b044291fc87181",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-Rawhide-20231205.n.1.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701800176,
            "size": 41214780,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "20aa9f672ce5fe06553b4e70f57413d020a6f97112c91cdb2223251de2f5ff7a",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-Rawhide-20231205.n.1.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701800796,
            "size": 162874232,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "3ddeef19a3332f60e571e1212d3788a96ac46d216ef2bd9240a8d96536f71ed8",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-Rawhide-20231205.n.1.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701800422,
            "size": 25140680,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "bd9bacff53369963e0e76d93a99b012ac2006692cd07c38cbdd72093487fb4fe",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-Rawhide-20231205.n.1.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701800254,
            "size": 45011640,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "9f7a10c2c1f188f90fa0cfaecaac3f317bed7372ae98643a3a1bc2e708a6c531",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-Rawhide-20231205.n.1.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701803045,
            "size": 28300404,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "e142c4513df1793fc6c6d3dc471b5fcf8f1933037a07e356077e5a357978ef60",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-Rawhide-20231205.n.1.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701803877,
            "size": 177546964,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "f9a216ddacc29674e2d00fa616adae801f70865c1d0f4f1a8b04477d6712ac05",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Everything-netinst-aarch64-Rawhide-20231205.n.1.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701794544,
            "size": 786626560,
            "bootable": true,
            "implant_md5": "0f314285b1bd64c72c9518c7da9cad54",
            "volume_id": "Fedora-E-dvd-aarch64-rawh",
            "md5": null,
            "sha1": null,
            "sha256": "a41c639af735e139ff85b56c5f76461cfa475120ee02ea9ce08f0649ef74a7a6",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Everything"
        },
        {
            "file_name": "Fedora-Everything-netinst-x86_64-Rawhide-20231205.n.1.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701794931,
            "size": 761686016,
            "bootable": true,
            "implant_md5": "9eb2ed8324a65f6152721ff23b2f517e",
            "volume_id": "Fedora-E-dvd-x86_64-rawh",
            "md5": null,
            "sha1": null,
            "sha256": "b3de132544fca8682022128266767b653552ddefb4ad95a2cf2fbe133f292a63",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Everything"
        },
        {
            "file_name": "Fedora-Everything-netinst-s390x-Rawhide-20231205.n.1.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701795334,
            "size": 469821440,
            "bootable": true,
            "implant_md5": "588381299d3baa9d4057b6b6b3eaa847",
            "volume_id": "Fedora-E-dvd-s390x-rawh",
            "md5": null,
            "sha1": null,
            "sha256": "31b1cef2bb5ca0970d3a97f413e5830426fbbcf6f217a1aa7fadf299aa061761",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Everything"
        },
        {
            "file_name": "Fedora-Everything-netinst-ppc64le-Rawhide-20231205.n.1.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701794838,
            "size": 757358592,
            "bootable": true,
            "implant_md5": "7f48dfb43e3d6ae270209936212d309a",
            "volume_id": "Fedora-E-dvd-ppc64le-rawh",
            "md5": null,
            "sha1": null,
            "sha256": "aa7a8436a2ba2f318dd2b15036fa9f28233d8a680aae1ebfb7a226276bce8415",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Everything"
        },
        {
            "file_name": "Fedora-Kinoite-ostree-aarch64-Rawhide-20231205.n.1.iso",
            "image_format": "iso",
            "image_type": "dvd-ostree",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701797673,
            "size": 4091934720,
            "bootable": true,
            "implant_md5": "14c7de26b3cc9982ea7aef13b4482017",
            "volume_id": "Fedora-Knt-ostree-aarch64-rawh",
            "md5": null,
            "sha1": null,
            "sha256": "830fa3deacd3bcae8742f3a763f4dde53ab15c99ebfd326095e53bb085d6f5bb",
            "composes": [
                "Fedora-Rawhide-20231205.n.1"
            ],
            "subvariant": "Kinoite"
        }
    ]
}