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

{
    "count": 278307,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=5",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/images/?page=3",
    "results": [
        {
            "file_name": "Fedora-Live-Jam_KDE-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456352873,
            "size": 2190475264,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "620240ec2fe7d6f43acdfb695f319141c40e4228efb4475a4dd5a6c851ae3995",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Security-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456350705,
            "size": 1212153856,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "3f01cb51992dc894493996f4013e0735e2134812d4ad6aa1848d6954d30c21ad",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Scientific_KDE-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456354278,
            "size": 3107979264,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "47feea770e79ac3e993054dc32b3755bdf6d3fc64791a0badd9e6e2f6b8246f0",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Security-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456350913,
            "size": 1214251008,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1b642db159449b9ec44c5292df2de09b98ae5f97aba5f499b924fd1b5382c3e3",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Jam_KDE-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456352527,
            "size": 2237661184,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "c1418da5ff8d6a341d91f8566634e084585ae8dbc16da529d74ceddc4b193a92",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Games-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456354001,
            "size": 4319084544,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "d3ca36db947bd79b5c3fd91aee7987b5c2bd3bb1379097473d6dab9ad9b8877a",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Scientific_KDE-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456354366,
            "size": 3343908864,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "2322f9f949097a5db770feb2db250274e0954e50296ecc80eb934aebf35d9a7f",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-x86_64-24-20160224.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456348129,
            "size": 1915748352,
            "bootable": true,
            "implant_md5": "34cacdc349a2cf1d0b35cc57997b37e4",
            "volume_id": "Fedora-S-dvd-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "2aa6301c1e21c0673ca51750b7e82c0e585c4e4d51174efe0ed91c68969d356d",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-x86_64-24-20160224.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456345873,
            "size": 473956352,
            "bootable": true,
            "implant_md5": "1e18b7a73442d79b6dcfcd74cdd0d973",
            "volume_id": "Fedora-S-boot-x86_64-24",
            "md5": null,
            "sha1": null,
            "sha256": "457b7da1a1605ac969f05858ad5a0ef0568f36c4ef6f6e4f386882b75e683837",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-boot-i386-24-20160224.n.0.iso",
            "image_format": "iso",
            "image_type": "boot",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456345022,
            "size": 538968064,
            "bootable": true,
            "implant_md5": "26a7ad0e7a8fe2d7534cd6c5f5d3c9d3",
            "volume_id": "Fedora-S-boot-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "7cf1f8b0bf45055f57d0686ec31dcde1923a07094ba06aa2e143ea6edeed7dc4",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-i386-24-20160224.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456348105,
            "size": 2061500416,
            "bootable": true,
            "implant_md5": "9b3ef142fc4a316ea3d9132963e4d3a2",
            "volume_id": "Fedora-S-dvd-i386-24",
            "md5": null,
            "sha1": null,
            "sha256": "e894012577859740d7795007d508a82eae1bb0b6dd9d30a1eb0f755130ce7fc6",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-armhfp-Rawhide-20160224.0-sda.raw.xz",
            "image_format": "raw.xz",
            "image_type": "raw-xz",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "armhfp",
            "mtime": 1456353664,
            "size": 565329228,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "f29c0a368a02a7bd0e13796e1245b4a3691ba7482a9f2633752fcd938cf5814a",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Server-dvd-armhfp-24-20160224.n.0.iso",
            "image_format": "iso",
            "image_type": "dvd",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "armhfp",
            "mtime": 1456348376,
            "size": 1790459904,
            "bootable": true,
            "implant_md5": "f49ad703bb7db46f03af9abe9e77f327",
            "volume_id": "Fedora-S-dvd-armhfp-24",
            "md5": null,
            "sha1": null,
            "sha256": "4713008410652734a4a86b856b89c8d527d4e3d67ba5eec58f926e5dc4cbc034",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Xfce-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456351130,
            "size": 1257242624,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "b758d447d07b2270de597b0c24de73b3ade78d185d9406f1b7cf27637fd968dd",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-LXDE-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456350984,
            "size": 1119879168,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "dcfa78ef6a7d5d3f1075812e3bfbb691d58f212e209f25faba67188d40603349",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-KDE-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456351131,
            "size": 1527775232,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "4d0f9e70d382d4a79d60b1d8c4a2ca72ccce903cf03f8b4ef6f536472d04c57f",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-SoaS-x86_64-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "x86_64",
            "mtime": 1456350385,
            "size": 943718400,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1ddcb455b7f00ed702e5cde52159fff93d039d2b7a98f9e85b3bd930dfeab547",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-SoaS-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456350780,
            "size": 975175680,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "e46a7297e62f82352166c014540c9e58e6efdf2de0fab21d02b2bf5c79e77054",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-Xfce-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456351372,
            "size": 1405091840,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "1b4dad6261f7ae4008b85d88c0f9b33444a6683e5c0c1c8904f81f513f10d29e",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        },
        {
            "file_name": "Fedora-Live-KDE-i386-Rawhide-20160224.0.iso",
            "image_format": "iso",
            "image_type": "live",
            "disc_number": 1,
            "disc_count": 1,
            "arch": "i386",
            "mtime": 1456351702,
            "size": 1689255936,
            "bootable": true,
            "implant_md5": null,
            "volume_id": null,
            "md5": null,
            "sha1": null,
            "sha256": "bdadb33a832a674e33432a13f04738cd0601d6c6e9e0e4023b257506390feb23",
            "composes": [
                "Fedora-24-20160224.n.0"
            ],
            "subvariant": ""
        }
    ]
}