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

## 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`
- 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/get.ts> (a function with typed inputs; its response is checked against the schema)

# 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

## Changes

- **2025-03-07** `328d929c7310`: 1 info
  - added the non-success response with the status `409`
- **2024-11-23** `f751fa2a43c9`: 9 warning
  - added the new `background_generation` enum value to the `generations/items/generation_type` response property for the response status `200` (media type: text/plain)
  - added the new `background_generation` enum value to the `generations/items/generation_type` response property for the response status `200` (media type: application/json)
  - added the new `background_generation` enum value to the `generations/items/generation_type` response property for the response status `200` (media type: text/json)
  - added the new `influence_outline_by_image` enum value to the `generations/items/generation_type` response property for the response status `200` (media type: text/plain)
  - …5 more
- **2024-08-26** `00000cbae4c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/ai/generation-history/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)