v1

latestOpenAPI 3.0.42026-07-1376217536.1 KB
AiGenerator

Retrieve history of AI generations

AI Generator - Generation History

Get the history of AI generation requests.

get/v3/ai/generation-history

Query parameters

date_startstring date-time

If included, limits the results to those generation requests made on or after date_start. Both dates and datetimes are supported. Dates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. Datetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ.

date_endstring date-time

If included, limits the results to those generation requests made on or before date_end. Both dates and datetimes are supported. Dates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. Datetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ.

media_type'photography' | 'illustration'

If included, limits the results to those generation requests made for the given media type.

page_sizeinteger

The page size of results. Default is 30.

pageinteger

The page number of results. Default is 1.

product_idsinteger[]

If included, limits the results to only those requests made against the indicated products.

company_generationsboolean

If true, returns the list of previously downloaded images for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false.

Response

Returns the history of AI generations

result_countinteger

The total count of results, ignoring paging