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

{
    "count": 84362,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=2",
    "previous": null,
    "results": [
        {
            "file_name": "Fedora-Cloud-boot-x86_64-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454415782,
            "size": 464519168,
            "bootable": true,
            "implant_md5": "091da31e6c97ad8961ee5abba6f20d2c",
            "volume_id": "Fedora-C-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "35bde6196f2178e4cbb3bcba42ea555a353d9649104e8a6fae56bd892c03c9fa",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Cloud-boot-i386-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454416184,
            "size": 521142272,
            "bootable": true,
            "implant_md5": "d6087a35d921034d01c2e2cb5a616ebc",
            "volume_id": "Fedora-C-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "b3649f3ee94898c58f925863a087838677d7c733149e75d2d0f1eb60e0a67837",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Everything-boot-x86_64-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454416267,
            "size": 464519168,
            "bootable": true,
            "implant_md5": "875b416f67ae0e6f1fbf1054cf191e79",
            "volume_id": "Fedora-Everything-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "28453997f9ce67f71e71efc27da85e605e9bbd58e2a55099a6f9501526bf8e79",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Everything-boot-i386-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454416647,
            "size": 522190848,
            "bootable": true,
            "implant_md5": "0f709f08f90a78375466e4b50daf053b",
            "volume_id": "Fedora-Everything-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "eb1a83f2f9978b8d8ccdb89046d6753d0929c3844984b532265728decf361ac0",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-x86_64-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454419633,
            "size": 1894776832,
            "bootable": true,
            "implant_md5": "01e3d149a020af0f4ef0488db86b92bd",
            "volume_id": "Fedora-S-dvd-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "de7cc6420a9217a2cf894311fd5232903c06a3e29c43782a3843ac658b575a08",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-x86_64-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454416765,
            "size": 466616320,
            "bootable": true,
            "implant_md5": "8d921038f50b054f423d75a86932020e",
            "volume_id": "Fedora-S-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "87cc2140ff3de774b2e0a02be6ee397b585c136c06c54da207593fa1ae4a45c4",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-i386-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454419673,
            "size": 2027945984,
            "bootable": true,
            "implant_md5": "59938d9fa2e8093459035caf58815dca",
            "volume_id": "Fedora-S-dvd-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "f8b1f81ecced845de5985809c72b268e73c51410aaf7e81864ffa017dafda51c",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-i386-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454416649,
            "size": 524288000,
            "bootable": true,
            "implant_md5": "4210eba8b85d20ec3a0b76b57b55f3b3",
            "volume_id": "Fedora-S-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "b4e7c468fbcf9862a4e857625bfc3f519ff89960837f28d7a6e1102fcb6b5078",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-armhfp-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "armhfp",
            "mtime": 1454419789,
            "size": 1759657984,
            "bootable": true,
            "implant_md5": "dd24b2370a74d8455ef38dcd8b0b9f0f",
            "volume_id": "Fedora-S-dvd-armhfp-24",
            "md5": null,
            "sha1": null,
            "sha256": "645ad1a68b72e756872d44813b8545f1b1df9835c1e806d560bc93ec544e0bdb",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Workstation-boot-x86_64-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454417127,
            "size": 464519168,
            "bootable": true,
            "implant_md5": "061e2fb7423edc832194083716b43775",
            "volume_id": "Fedora-WS-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "ead3df60de676dd926070b6710fadbe37e2e91e3720795567501abcf4e349f3c",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Workstation-boot-i386-24-20160202.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454416200,
            "size": 521142272,
            "bootable": true,
            "implant_md5": "061690e1f5e9149fafdc2f0d6ccc16ba",
            "volume_id": "Fedora-WS-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "baf5ddafe6470c645ff0eb89ee661f691d7965bbc139a50ea835334ff00831c3",
            "composes": [
                "Fedora-24-20160202.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Cloud-boot-x86_64-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454475951,
            "size": 464519168,
            "bootable": true,
            "implant_md5": "974ff8429832a36b2e1cf2f38f6d7fbb",
            "volume_id": "Fedora-C-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "ffcda1eb0acffedcda53d2afbc8e850e0ee550aae46eca8e775e69eb6bb697cb",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Cloud-boot-i386-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454476159,
            "size": 521142272,
            "bootable": true,
            "implant_md5": "3edd8a7ba15c2b0e870eca47db627d47",
            "volume_id": "Fedora-C-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "0e4d20ad7947e764d672465ebb6f5f9eaf29c7bae3e435f3d4970f6f28f0e8e1",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Everything-boot-x86_64-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454475920,
            "size": 464519168,
            "bootable": true,
            "implant_md5": "2566228d81552b8bf0d7e11566a407b5",
            "volume_id": "Fedora-Everything-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "47273668f13eade5527bd4c5f600d4d402cb1425ae8d35b10954e6d62fcd09f0",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Everything-boot-i386-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454475896,
            "size": 521142272,
            "bootable": true,
            "implant_md5": "e0cafe9bf8485e48a30175ef8423faaa",
            "volume_id": "Fedora-Everything-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "116499e43949ccea0869d116e66875eb36105e25204bcd294512d35356ab8386",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-x86_64-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454476877,
            "size": 467664896,
            "bootable": true,
            "implant_md5": "195d18c7c0177a13167ee132d2864339",
            "volume_id": "Fedora-S-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "82d36bcc15dbaf66e0e443f42ba9e3bdaf54ba8fdde21e7ce7278713f9a2aa78",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-x86_64-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1454480970,
            "size": 1894776832,
            "bootable": true,
            "implant_md5": "b9437d6be85c2ffbe3d35e26097cadf0",
            "volume_id": "Fedora-S-dvd-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "1363c58385abff1bdc03cd67eb8e87337cbb678f2b69c3a3644bdd6556a6b1a7",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-i386-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454476203,
            "size": 524288000,
            "bootable": true,
            "implant_md5": "fe941ce54ad75278fd815935774857ae",
            "volume_id": "Fedora-S-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "a0002a49bbf5c3a85b5224225fc5ba29536ca35bf468828f67e99917594c77b0",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-i386-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1454480927,
            "size": 2028994560,
            "bootable": true,
            "implant_md5": "a8e8d5c42fed6cda30d53525acf8fff5",
            "volume_id": "Fedora-S-dvd-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "56068e863f8b453f835a79e1e7f163854d926665ea7d3850b55c00014c66042b",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-armhfp-24-20160203.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "armhfp",
            "mtime": 1454481259,
            "size": 1758998528,
            "bootable": true,
            "implant_md5": "38f95fc4a791291a694b5bd61894a785",
            "volume_id": "Fedora-S-dvd-armhfp-24",
            "md5": null,
            "sha1": null,
            "sha256": "b936b1381d84705e01f75167654555e21add61fb15d617bd2b47abfb4efd3683",
            "composes": [
                "Fedora-24-20160203.n.0"
            ],
            "subvariant": ""
        }
    ]
}