---
title: "list editorial image details"
method: GET
path: "/v2/editorial/images"
tags: ["editorial_images"]
---

# list editorial image details

`GET /v2/editorial/images`

This endpoint lists the details of editorial images.

## Query parameters

- `id` string[], required
- `country` string, country-code-3, required
- `search_id` string

## Response `200`

OK

- object — List of editorial images
  - `data` object[]
    - `aspect` number
    - `assets` object — Asset information, including size and thumbnail URLs
      - `original` 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
      - `thumb_170` 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
      - `thumb_220` 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
      - `watermark_450` 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
      - `watermark_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
      - `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
    - `byline` string
    - `caption` string
    - `categories` object[] — List of categories
      - `name` string
    - `date_taken` string, date
    - `description` string
    - `id` string, required
    - `keywords` string[]
    - `special_instructions` string
    - `title` string
  - `search_id` string
  - `total_count` integer

## 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)