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

# 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

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)
