---
title: "Retrieve history of AI generations"
method: GET
path: "/v3/ai/generation-history"
tags: ["AiGenerator"]
---

# Retrieve history of AI generations

`GET /v3/ai/generation-history`

# AI Generator - Generation History

Get the history of AI generation requests.

## Query parameters

- `date_start` string, date-time
- `date_end` string, date-time
- `media_type` 'photography' | 'illustration'
- `page_size` integer
- `page` integer
- `product_ids` integer[]
- `company_generations` boolean

## Response `200`

Returns the history of AI generations

- GenerationHistoryResponse — Full generation history response
  - `generations` GenerationHistoryItemResponse[], nullable — Current page of generations
    - `generation_request_id` string, nullable — The identifier for the request
    - `seed` integer, nullable
    - `generation_date` string, date-time
    - `product_revoked_date` string, date-time, nullable — If the the product against which the generation was made has been revoked, this is the date of that revocation.
    - `prompt` string, nullable — The prompt that was used for the request
    - `negative_prompt` string, nullable — The negative prompt (if any) that was used for the request
    - `product_id` integer
    - `notes` string, nullable
    - `project_code` string, nullable
    - `generation_type` 'text_to_image' | 'variation' | 'extend' | 'refine' | 'background_removal' | 'influence_color_by_image' | 'influence_composition_by_image' | 'object_removal' | 'influence_outline_by_image' | 'background_generation'
    - `generation_options` GenerationOptions
      - `media_type` 'photography' | 'illustration'
      - `aspect_ratio` string, nullable
      - `mood` 'black_and_white' | 'warm' | 'cool' | 'natural' | 'vivid' | 'dramatic' | 'bold'
    - `source_generation_request` SourceGenerationRequest
      - `source_generation_request_id` string, nullable
      - `source_generation_result_index` integer
    - `original_asset` AssetDetail
      - `id` string, nullable
    - `results` GenerationHistoryResult[], nullable
      - `index` integer — The index of the result from the original generation
      - `is_blocked` boolean — If `true` the result was blocked due to AI generation policy
      - `preview_urls` PreviewUrl[], nullable — The preview URLs for the result
        - `preview_size` string, nullable
        - `image_url` string, nullable
        - `width` integer
        - `height` integer
    - `user` User
      - `username` string, nullable
      - `first_name` string, nullable
      - `middle_name` string, nullable
      - `last_name` string, nullable
  - `result_count` integer — The total count of results, ignoring paging

## Other responses

- `403` — Company generations were requested but your account is not configured for access.
- `409` — ConcurrencyConflict

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)