GET /beta/ai/generation-history

AI Generator - Generation History

Get the history of AI generation requests.

Servers

Query parameters

Name Type Required Description
page Integer No

The page number of results. Default is 1.

product_ids[] Array No

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

date_start String No

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.

page_size Integer No

The page size of results. Default is 30.

media_type String No

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

Valid values:

  • "illustration"
  • "photography"
company_generations Boolean No

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.

Default value: false

date_end String No

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.