---
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}`

## Request

- Base URL: `https://api.gettyimages.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gettyimages.com/v3/ai/generation-history/{generationRequestId}`
- Auth: one of:
  - API key in header `Api-Key`
  - OAuth 2
    - Authorization code: `https://authentication.gettyimages.com/oauth2/auth`
    - Client credentials
    - Password
    - Token URL: `https://authentication.gettyimages.com/oauth2/token`
- TypeScript: <https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/ai/generation-history/:generationRequestId/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2025-03-07** `328d929c7310`: 1 info
  - added the non-success response with the status `409`
- **2024-11-23** `f751fa2a43c9`: 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `text/json` for the response with the status `200`
  - added the media type `text/plain` for the response with the status `200`
- **2024-08-26** `00000cbae4c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/ai/generation-history/:generationRequestId/get.md)

---

[API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [All operations](https://skmtc.dev/gettyimages/apis/getty-images-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gettyimages/apis/getty-images-api/revisions/f20ce986456b?raw)