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=12893
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=12894",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=12892",
    "results": [
        {
            "file_name": "Fedora-IoT-ostree-aarch64-39-20231204.0.iso",
            "image_format": "iso",
            "image_type": "dvd-ostree",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701704920,
            "size": 1396475904,
            "bootable": true,
            "implant_md5": "53e135f08aadc3fe12b5de58fa499a1b",
            "volume_id": "Fedora-iot-ostree-aarch64-39",
            "md5": null,
            "sha1": null,
            "sha256": "308f8e141240bc3bd6685a8cc84bd3cfadc9bb25ee574047a6f9440c39b7100c",
            "composes": [
                "Fedora-IoT-39-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-ostree-x86_64-39-20231204.0.iso",
            "image_format": "iso",
            "image_type": "dvd-ostree",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701705219,
            "size": 1343989760,
            "bootable": true,
            "implant_md5": "35c261efa2ea3519da0d6b621f0776be",
            "volume_id": "Fedora-iot-ostree-x86_64-39",
            "md5": null,
            "sha1": null,
            "sha256": "b8f3893cb19bc5ac05840d592652177b97cf6c028d1385f140ddb732b70fc0f5",
            "composes": [
                "Fedora-IoT-39-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-39.20231204.0-20231204.0.x86_64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701705706,
            "size": 690119264,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "0b7e78b8516c09f53922e84bcb3b7956513fac62e70d61f44e800d8d9f3e8050",
            "composes": [
                "Fedora-IoT-39-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-ostree-39.20231204.0-20231204.0.x86_64.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701706242,
            "size": 2425569280,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "7c80bc12f7cdb521c6edd02415a25bd71d67182c37f801c00bcde7fb8866e780",
            "composes": [
                "Fedora-IoT-39-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-ostree-40.20231204.0-20231204.0.aarch64.iso",
            "image_format": "iso",
            "image_type": "dvd-ostree",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701708416,
            "size": 2460385280,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "94d1b01856ea1dc7f2756a760fe3453453372854478608984d8bbd13a593a053",
            "composes": [
                "Fedora-IoT-40-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-40.20231204.0-20231204.0.aarch64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701707938,
            "size": 746940888,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1ee8db2ce15181c84e4b438702e4880a21cfc19c5fd3cfda812f0492c602f4c5",
            "composes": [
                "Fedora-IoT-40-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-ostree-40.20231204.0-20231204.0.x86_64.iso",
            "image_format": "iso",
            "image_type": "dvd-ostree",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701708583,
            "size": 2466250752,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "bd6e91528cbf1962f3a851e1f579fb9076530001c1edac2ec61913dbc8e1dcd1",
            "composes": [
                "Fedora-IoT-40-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-IoT-40.20231204.0-20231204.0.x86_64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701707839,
            "size": 718475636,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "68962b3addd6d15a83f3778a13b4119d4f7075813a259d3674ec7370865d5413",
            "composes": [
                "Fedora-IoT-40-20231204.0"
            ],
            "subvariant": "IoT"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.aarch64.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701761187,
            "size": 582680576,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "2c8e98585b093011653b0037fcd6fec398c6405fa905ae01a75dd4b71b89a885",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.aarch64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701761216,
            "size": 483609148,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "470beb3b030ac3becf7606909f6f7eb544986704930a4a3c4819a0d389d4e625",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.x86_64.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701761212,
            "size": 572063744,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "4dc9e3eae9216ea9ac89d789df13495928e295af870a257b99eace48a69e3b7b",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Vagrant-38-20231205.0.x86_64.vagrant-virtualbox.box",
            "image_format": "vagrant-virtualbox.box",
            "image_type": "vagrant-virtualbox",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701761551,
            "size": 579758080,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "2b88366d93ab57ebfba5ae5cc2400a3862a7a5ab4ea81e634313fd3aaf63d09f",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.x86_64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701761239,
            "size": 479290944,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "39f9506e2826004d48279d5e453b1d249aa9462cb66a5cbb619a47c8a8cdf071",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-Vagrant-38-20231205.0.x86_64.vagrant-libvirt.box",
            "image_format": "vagrant-libvirt.box",
            "image_type": "vagrant-libvirt",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1701761515,
            "size": 567691218,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "fb40cb83017d2162f1bdcf559f87dbf421ddf4d45ab37ecbd52e759cc422164f",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.s390x.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701761185,
            "size": 548208640,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "e5edba42fb45f819543f90a72526fdaab974c7259a5cdc5175375f942ab030a3",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.s390x.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1701761225,
            "size": 463558944,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "b2d0ff458c5151715ae79520d670118ebcef0dd4d62c5c3d61b1a2a9aecc0dff",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.ppc64le.qcow2",
            "image_format": "qcow2",
            "image_type": "qcow2",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701761437,
            "size": 573308928,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "78208ef65db100db32463dd320966f104b502848761afb98680269e8cb8267bc",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Cloud-Base-38-20231205.0.ppc64le.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1701761460,
            "size": 397364112,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "bee4f6e9894f66095383c41c963f4f76c20a5cc9004f72db8bd9ae2dd0b535bd",
            "composes": [
                "Fedora-Cloud-38-20231205.0"
            ],
            "subvariant": "Cloud_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-39-20231205.0.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701762600,
            "size": 23914184,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "b420851996df2a3b66ff72316631fa8faac4baa9f7eb539b26ab698c5522da39",
            "composes": [
                "Fedora-Container-39-20231205.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-39-20231205.0.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1701762609,
            "size": 40626600,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "98e1830b2318688669f7566b998a76635a14b3b826428de1c9c2454a2340889c",
            "composes": [
                "Fedora-Container-39-20231205.0"
            ],
            "subvariant": "Container_Base"
        }
    ]
}