--- title: "List images" method: GET path: "/v2/images" tags: ["images"] --- # List images `GET /v2/images` This endpoint lists information about one or more images, including the available sizes. ## Query parameters - `id` string[], required - `view` 'minimal' | 'full' - `search_id` string ## Response `200` OK - object — List of images - `data` object[] — Images - `added_date` string, date — Date that the image was added by the contributor - `affiliate_url` string, uri — Affiliate referral link; appears only for registered affiliate partners - `aspect` number — Aspect ratio of the image in decimal format, such as 0.6667 - `assets` object — Image asset information - `huge_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `huge_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `large_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `medium_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `preview` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `preview_1000` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `preview_1500` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `small_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `small_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `supersize_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `vector_eps` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `mosaic` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `categories` object[] — Categories that this image is a part of - `id` string — Category ID - `name` string — Category name - `contributor` object, required — Information about a contributor - `id` string, required — ID of the contributor - `description` string — Detailed description of the image - `has_model_release` boolean — Indicates whether there are model releases for the image - `has_property_release` boolean — Indicates whether there are property releases for the image - `id` string, required — Image ID - `image_type` string — Type of image - `is_adult` boolean — Whether or not this image contains adult content - `is_editorial` boolean — Whether or not this image is editorial content - `is_illustration` boolean — Whether or not this image is an illustration - `keywords` string[] — Keywords associated with the content of this image - `media_type` string, required — Media type of this image, should always be "image" - `model_releases` object[] — List of model releases - `id` string — ID of the model or property release - `models` object[] — List of models - `id` string, required — ID of the model - `releases` string[] — List of all releases of this image - `url` string — Link to image information page; included only for certain accounts - `errors` object[] — Error list; appears only if there was an error - `code` string — The error code of this error - `data` string — Debugging information about the error - `items` object[] — A list of items that produced the error - `message` string, required — Specific details about this error - `path` string — Internal code reference to the source of the error - `message` string — Server-generated message, if any - `page` integer — Current page that is returned - `per_page` integer — Number of results per page - `total_count` integer — Total count of all results across all pages ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden --- [API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)