SHshutterstock
generative

List image generation history

Changed on

Returns image generation history for the authenticated user.

get/v2/generative/images/history

Request

Query parameters

pageinteger

Page number of the results to return.

per_pageinteger

Number of results to return per page.

sort_order'asc' | 'desc'

Sort order for generation request time.

promptstring

Search generation history by prompt text.

status'COMPLETED' | 'FAILED' | 'GENERATING' | 'PENDING'

Filter generation history by generation status.

generation_type'image-generation' | 'image-variation' | 'image-smart-edit'

Filter generation history by image generation category.

Response

OK

pageinteger required

The current page of results.

per_pageinteger required

The number of results per page.

total_countinteger required

The total number of results across all pages.

Example response

{
  "data": [
    {
      "id": "437220fe-0a83-4fcf-899f-4ec7829bed90",
      "status": "COMPLETED",
      "request_time": "2026-05-05T10:30:47.747000+00:00",
      "is_private": false,
      "can_register_assets": true,
      "error_code": null,
      "generation_type": "image-generation",
      "prompt": "dog playing a banjo",
      "aspect_ratio": "1:1",
      "style": null,
      "model": null,
      "assets": [
        {
          "id": "asset-generation-437220fe-0a83-4fcf-899f-4ec7829bed90-0",
          "description": "Low poly 3D image of dog playing a banjo",
          "image_id": "4302402011",
          "ai_ip_review": {
            "status": "pending",
            "rejection_reasons": []
          },
          "small": {
            "url": "https://generated-assets-cdn.qa.shutterstock.com/asset-generation-437220fe-0a83-4fcf-899f-4ec7829bed90/asset-generation-437220fe-0a83-4fcf-899f-4ec7829bed90-0-small.jpg",
            "height": 512,
            "width": 512
          },
          "watermarked": {
            "url": "https://generated-assets-cdn.qa.shutterstock.com/asset-generation-437220fe-0a83-4fcf-899f-4ec7829bed90/asset-generation-437220fe-0a83-4fcf-899f-4ec7829bed90-0-small.jpg",
            "height": 512,
            "width": 512
          }
        }
      ]
    }
  ],
  "page": 3,
  "per_page": 2,
  "total_count": 5
}

Changes