---
updatedAt: 2026-03-01T18:45:20.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/ivm/llms.txt
---

# List images

List a policy's images.

# OpenAPI definition

```json
{
  "externalDocs": {
    "description": "See documentation for Akamai's Image and Video Manager API",
    "url": "https://techdocs.akamai.com/ivm/reference"
  },
  "info": {
    "title": "Images",
    "version": "2"
  },
  "openapi": "3.0.0",
  "paths": {
    "/network/{network}/images": {
      "get": {
        "description": "List a policy's images.\n",
        "externalDocs": {
          "description": "See documentation for this operation in Akamai's Image and Video Manager API",
          "url": "https://techdocs.akamai.com/ivm/reference/get-images"
        },
        "operationId": "get-images",
        "parameters": [
          {
            "description": "Specifies maximum number of items to get.\n",
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 1000,
              "example": 2,
              "type": "integer"
            },
            "x-akamai": {
              "file-path": "parameters/limit-query.yaml"
            }
          },
          {
            "description": "URL to search for.\n",
            "in": "query",
            "name": "url",
            "schema": {
              "example": "http://www.example.com/image2.png",
              "type": "string"
            },
            "x-akamai": {
              "file-path": "parameters/url-query.yaml"
            }
          },
          {
            "description": "The policy to list images for.\n",
            "in": "query",
            "name": "policyId",
            "schema": {
              "example": "thumbnail_policy",
              "type": "string"
            },
            "x-akamai": {
              "file-path": "parameters/policy-id-query.yaml"
            }
          },
          {
            "description": "Runs the operation from [another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).\n",
            "in": "query",
            "name": "accountSwitchKey",
            "required": false,
            "schema": {
              "example": "1-5C0YLB:1-8BYUX",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "itemKind": "IMAGE",
                  "items": [
                    {
                      "id": "/uploads/image/header/small/bike-sale.jpg",
                      "url": "https://images.example.com/uploads/image/header/small/bike-sale.jpg"
                    },
                    {
                      "id": "/uploads/image/header/large/spring-cleaning.jpg",
                      "url": "https://images.example.com/uploads/image/header/large/spring-cleaning.jpg"
                    },
                    {
                      "errors": [
                        "2022-04-09 16:02:47+0000: Image processing tasks did not complete successfully. No offline images were saved."
                      ],
                      "id": "/uploads/image/showcase/item/sport-bike.jpg",
                      "url": "https://images.example.com/uploads/image/showcase/item/sport-bike.jpg"
                    }
                  ],
                  "totalItems": 2
                },
                "schema": {
                  "additionalProperties": false,
                  "description": "Allows you to manage the images you're using with Image & Video Manager.\n",
                  "properties": {
                    "itemKind": {
                      "description": "The type of item returned, `IMAGE` in this case.\n",
                      "enum": [
                        "IMAGE"
                      ],
                      "type": "string"
                    },
                    "items": {
                      "description": "A detailed list of the images returned.\n",
                      "items": {
                        "additionalProperties": false,
                        "description": "Collects information that describes an image.\n",
                        "properties": {
                          "errors": {
                            "description": "Any errors associated with an image.\n",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "id": {
                            "description": "The ID of the image.\n",
                            "type": "string"
                          },
                          "url": {
                            "description": "The URL of the image.\n",
                            "type": "string"
                          }
                        },
                        "type": "object",
                        "x-akamai": {
                          "file-path": "schemas/images-image.yaml"
                        }
                      },
                      "type": "array"
                    },
                    "totalItems": {
                      "description": "The total number of images returned.\n",
                      "type": "integer"
                    }
                  },
                  "type": "object",
                  "x-akamai": {
                    "file-path": "schemas/images-array.yaml"
                  }
                }
              }
            },
            "description": "The request was successful.\n"
          }
        },
        "summary": "List images",
        "tags": [
          "Images"
        ]
      },
      "parameters": [
        {
          "description": "__Enum__. Network environment to execute the API request on.\n",
          "in": "path",
          "name": "network",
          "required": true,
          "schema": {
            "enum": [
              "staging",
              "production"
            ],
            "example": "production",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/network-path.yaml"
          }
        },
        {
          "description": "Unique identifier for the Akamai Contract containing the policy sets. Required if you have access to more than one contract with Image & Video Manager.\n",
          "in": "header",
          "name": "Contract",
          "required": false,
          "schema": {
            "example": "1-1TJZFB",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/contract-id-header.yaml"
          }
        },
        {
          "description": "Unique identifier for the Image & Video Manager policy set.\n",
          "in": "header",
          "name": "Policy-Set",
          "required": true,
          "schema": {
            "example": "053eef00-9f85-11ec-a51d-47eefacf795d",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/policy-set-id-header.yaml"
          }
        }
      ]
    }
  },
  "servers": [
    {
      "url": "https://{hostname}/imaging/v2"
    }
  ],
  "tags": [
    {
      "description": "Groups operations that provide details about your images.",
      "name": "Images"
    }
  ],
  "x-akamai": {
    "auth-type": "EDGE_GRID",
    "file-path": "01-images.yaml"
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "python",
      "node"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```

# Sibling pages

* [Get an image](https://techdocs.akamai.com/ivm/reference/get-image.md)