---
title: "List image generation history"
method: GET
path: "/v2/generative/images/history"
tags: ["generative"]
---

# List image generation history

`GET /v2/generative/images/history`

## Request

- Base URL: `https://api.shutterstock.com`
- URL: `https://api.shutterstock.com/v2/generative/images/history`
- Auth: OAuth 2
  - Authorization code: `https://accounts.shutterstock.com/oauth/authorize`
  - Token URL: `https://api.shutterstock.com/v2/oauth/access_token`
- TypeScript: <https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/generative/images/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns image generation history for the authenticated user.

## Query parameters

- `page` integer
- `per_page` integer
- `sort_order` 'asc' | 'desc'
- `prompt` string
- `status` 'COMPLETED' | 'FAILED' | 'GENERATING' | 'PENDING'
- `generation_type` 'image-generation' | 'image-variation' | 'image-smart-edit'

## Response `200`

OK

- object: List of image generation history records.
  - `data` object[], required: Image generation history records.
    - `id` string, required: The generation request ID.
    - `status` 'COMPLETED' | 'FAILED' | 'GENERATING' | 'PENDING' | 'NOT_FOUND', required: The status of the generation request.
    - `request_time` string, date-time, required: The time at which the generation request was received.
    - `is_private` boolean, required: Whether the generation is private.
    - `can_register_assets` boolean, nullable: Whether generated assets are eligible for registration.
    - `error_code` string, nullable: Error code if the generation failed.
    - `generation_type` 'image-generation' | 'image-variation' | 'image-smart-edit': Image generation category derived from the generation metadata type.
    - `prompt` string: The text prompt used for the generation.
    - `aspect_ratio` string: The generated image aspect ratio.
    - `style` object, nullable, required
      - `id` string
      - `name` string
    - `model` string, nullable, required: The image generation model identifier.
    - `assets` object[], required
      - `id` string, required: The generated image asset ID.
      - `description` string, required: The generated image description.
      - `image_id` string: Registered Shutterstock image ID for this generated asset, if registered.
      - `ai_ip_review` object: Current AI IP review information for the registered generated image, if available.
        - `status` string: Current status of the AI IP review process
        - `rejection_reasons` string[]: Reasons the AI IP review was rejected, if any
      - `small` object, required
        - `url` string, required: Preview URL.
        - `height` integer, required: Preview height in pixels.
        - `width` integer, required: Preview width in pixels.
      - `watermarked` object, required
        - `url` string, required: Preview URL.
        - `height` integer, required: Preview height in pixels.
        - `width` integer, required: Preview width in pixels.
  - `page` integer, required: The current page of results.
  - `per_page` integer, required: The number of results per page.
  - `total_count` integer, required: The total number of results across all pages.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-14** `b43cab3aaaaa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/changes/v2/generative/images/history/get.md)

---

[API](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer.md) - [All operations](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/revisions/b43cab3aaaaa?raw)