---
title: "List updated content"
method: GET
path: "/v2/editorial/images/updated"
tags: ["editorial_images"]
---

# List updated content

`GET /v2/editorial/images/updated`

This endpoint lists editorial images that have been updated in the specified time period to update content management systems (CMS) or digital asset management (DAM) systems. In most cases, use the date_updated_start and date_updated_end parameters to specify a range updates based on when the updates happened. You can also use the date_taken_start and date_taken_end parameters to specify a range of updates based on when the image was taken.

## Query parameters

- `type` 'edit' | 'addition', required
- `date_updated_start` string, date-time, required
- `date_updated_end` string, date-time, required
- `date_taken_start` string, date
- `date_taken_end` string, date
- `cursor` string
- `sort` 'newest' | 'oldest'
- `supplier_code` string[]
- `country` string, country-code-3, required
- `per_page` integer

## Response `200`

OK

- object — Editorial updated results
  - `data` object[], required — Editorial updated items
    - `commercial_status` object
      - `status` string
      - `reason` string
    - `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[]
    - `title` string
    - `updated_time` string, date-time
    - `created_time` string, date-time
    - `rights` object
      - `countries` string
    - `updates` string[]
    - `supplier_code` string
    - `special_instructions` string
  - `message` string — Optional error message
  - `next` string — Cursor value that represents the next page of results
  - `per_page` integer — Number of results per page
  - `prev` string — Cursor value that represents the previous page of results

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `406` — Not Acceptable

---

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