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

{
    "count": 282273,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=13922",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=13920",
    "results": [
        {
            "file_name": "Fedora-Workstation-Rawhide-20240424.n.0.aarch64.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713946663,
            "size": 2851261260,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "07535be9df20270e325dd2113ce1c3a46825a9658a5164b213868b61344387c4",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-aarch64-Rawhide-20240424.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713945200,
            "size": 2274140160,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "4c8e8dbfb4d8052f3f5a7744b7c8836060905f72b5a5601199132a6524df3734",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-osb-Rawhide-20240424.n.0.aarch64.iso",
            "image_format": "iso",
            "image_type": "live-osbuild",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713946719,
            "size": 2601058304,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "e1329ec2bd30d0aa099ec67912bfe029a8e4b73f389932f7334679030dbf38c8",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-osb-Rawhide-20240424.n.0.x86_64.iso",
            "image_format": "iso",
            "image_type": "live-osbuild",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1713947553,
            "size": 2648211456,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "2269244b26464f87b90ef939f685d4bff4382da9dc63b1938d6bad237eaa7569",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-x86_64-Rawhide-20240424.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1713945641,
            "size": 2307319808,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "9d665682a272d97afd8456aed7a4c02fcb9586f886de1fc83fea0a3e18b3c5fe",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Workstation-Live-ppc64le-Rawhide-20240424.n.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1713945620,
            "size": 2255740928,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "2e054338b046cddfdfb5080ec91f40df60869bf7165844d52b244c2023b8edae",
            "composes": [
                "Fedora-Rawhide-20240424.n.0"
            ],
            "subvariant": "Workstation"
        },
        {
            "file_name": "Fedora-Container-Base-39-20240424.0.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713945330,
            "size": 40583656,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "b8c4218d2e744025be52361a0654468634fc7dcd468f615ff5e95129ae92d379",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-39-20240424.0.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713945651,
            "size": 172738500,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "43ded5832e8092cb1b61302295f653f5f54afff405eaa4c288998d4592c6de43",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-39-20240424.0.aarch64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1713945281,
            "size": 24424184,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "376c116b11c2a6a5f79e1fccab3a0d55d87c50ee5199a62f33c89373b121d478",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-39-20240424.0.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1713945053,
            "size": 43260636,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "c8ec8c5608402cb88e270394f769bbd8cfc97087f8a1c2758a3e91487c432037",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-39-20240424.0.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1713945118,
            "size": 194168244,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "f0e8f2ef1c107bb3aa70719ec1368b1251bb3acbd98e42f45febed68f2501836",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-39-20240424.0.x86_64.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1713945035,
            "size": 26662260,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "477661d3be80bda925d79ab9b164a689c432f5a2c084b94515da73902925b412",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-39-20240424.0.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1713945162,
            "size": 162052732,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "ee1fe9bfd116a46921b947ffd3c9bb084d1986884e56cedd87c4ba200e88321b",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Base-39-20240424.0.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1713945046,
            "size": 41733548,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "31348fe986d75eb45216ea324b580ad22c3b1e085c387eb0c4639a3cb9858584",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-39-20240424.0.s390x.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "s390x",
            "mtime": 1713945023,
            "size": 25519788,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "711a5dc7a3c53d364f96ae4c6184fddb8a860c3fafcb13b6b955ad5577b2c5a6",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-39-20240424.0.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1713948223,
            "size": 45018204,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "683dd3ef6697455a7d761741de7bbe327050defac8cdce156a87b16e1dbced5f",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Base"
        },
        {
            "file_name": "Fedora-Container-Minimal-Base-39-20240424.0.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1713948102,
            "size": 28315692,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "711b8dead72c34d8a13316649cd587bfc304cd2648e71c38aabd1a884d59f6a2",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Toolbox-39-20240424.0.ppc64le.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "ppc64le",
            "mtime": 1713949274,
            "size": 176715612,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "ca1422993cdb4d97a85f4330f92150470a3836f1ed3e319b00e428fec4094f0a",
            "composes": [
                "Fedora-Container-39-20240424.0"
            ],
            "subvariant": "Container_Toolbox"
        },
        {
            "file_name": "Fedora-Container-Base-Generic-Minimal.aarch64-40-20240425.0.oci.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1714024143,
            "size": 45745768,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "88d11a4825e0a64a2cb2b59be446c036b1a0437eba0d9f1c643c3b9eea54f32a",
            "composes": [
                "Fedora-Container-40-20240425.0"
            ],
            "subvariant": "Container_Minimal_Base"
        },
        {
            "file_name": "Fedora-Container-Base-Generic.aarch64-40-20240425.0.oci.tar.xz",
            "image_format": "tar.xz",
            "image_type": "docker",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "aarch64",
            "mtime": 1714024302,
            "size": 80125932,
            "bootable": false,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "544b169cde2456d20e492117c1e0b002247af5cf8534317720e9cdcd9b75b154",
            "composes": [
                "Fedora-Container-40-20240425.0"
            ],
            "subvariant": "Container_Base"
        }
    ]
}