---
title: "Retrieve history item for an individual generation request"
method: GET
path: "/v3/ai/generation-history/{generationRequestId}"
tags: ["AiGenerator"]
---

# Retrieve history item for an individual generation request

`GET /v3/ai/generation-history/{generationRequestId}`

## Path parameters

- `generationRequestId` string, required

## Response `200`

Returns the history item for the request

- GenerationHistoryItemResponse — Detail on a specific historical generation
  - `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

## Other responses

- `403` — NotAuthorized
- `404` — The request ID was not found
- `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)