---
title: "Once the download process has started, this endpoint can be used to check the status of the download and get the download URL once it is completed."
method: GET
path: "/v3/ai/image-generations/{generationRequestId}/images/{index}/download"
tags: ["AiGenerator"]
---

# Once the download process has started, this endpoint can be used to check the status of the download and get the download URL once it is completed.

`GET /v3/ai/image-generations/{generationRequestId}/images/{index}/download`

## 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/image-generations/{generationRequestId}/images/{index}/download`
- 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/image-generations/:generationRequestId/images/:index/download/get.ts> (a function with typed inputs; its response is checked against the schema)

# AI Generator - Get Download Image

Get the download for a generated image

## Fulfilled and Pending Results

In many cases the result of this call will be the final fulfilled result. In these cases, you will see a `HTTP 200 OK`
result and a payload including a URL for the download.

However some generations may take more time than can be accommodated in the initial call. In these cases the result of
this call is `HTTP 202 Accepted` with no payload. This client should then
poll `GET v3/ai/image-generations/{generationRequestId}/images/{index}/download` periodically to get the final
download.

Like the `PUT v3/ai/image-generations/{generationRequestId}/images/{index}/download` endpoint, the result of calling
this endpoint will be either:

- `HTTP 200 OK` with the download URL
- `HTTP 202 Accepted` with no payload

`HTTP 202 Accepted` is returned in the case where the download preparation has not yet completed. In this case it is
expected that the client will occasionally poll this endpoint until a `HTTP 200 OK` result with a full payload is
returned.

## Path parameters

- `generationRequestId` string, required
- `index` integer, required

## Response `200`

Download request was successful and is complete

- DownloadResponse
  - `url` string, nullable
  - `generated_asset_id` string, nullable

## Other responses

- `202`: Download request was successful put is pending
- `400`: InvalidProduct
- `403`: NotAuthorized
- `404`: GenerationRequestIdNotFound
- `409`: ConcurrencyConflict
- `410`: GenerationRequestGone
- `429`: DailyRequestLimitExceeded

## Changes

- **2025-03-07** `328d929c7310`: 3 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `409`
  - added the non-success response with the status `429`
- **2024-11-23** `f751fa2a43c9`: 3 info
  - added the non-success response with the status `410`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `429`
- **2024-08-26** `00000cbae4c7`: 1 info
  - endpoint added

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