---
title: "Returns information about a customer's download history for a specific asset"
method: GET
path: "/v3/images/{id}/downloadhistory"
tags: ["Images"]
---

# Returns information about a customer's download history for a specific asset

`GET /v3/images/{id}/downloadhistory`

## Path parameters

- `id` string, required

## Query parameters

- `company_downloads` boolean

## Headers

- `Accept-Language` string — Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).

## Response `200`

OK

- GettyImagesServicesConnectPublicModelsAssetDownloadHistoryAssetDownloadHistoryResponse
  - `id` string, nullable
  - `downloads` GettyImagesServicesConnectPublicModelsAssetDownloadHistoryAssetDownload[], nullable
    - `agreement_name` string, nullable
    - `asset_type` string, nullable
    - `date_downloaded` string, date-time
    - `download_notes` string, nullable
    - `download_source` string, nullable
    - `product_id` integer
    - `product_type` string, nullable
    - `project_code` string, nullable
    - `thumb_uri` string, nullable
    - `user` GettyImagesServicesConnectPublicModelsDownloadsUser
      - `username` string, nullable
      - `first_name` string, nullable
      - `middle_name` string, nullable
      - `last_name` string, nullable

## Other responses

- `400` — Bad request
- `401` — AuthorizationTokenRequired
- `403` — UnauthorizedDisplaySize
- `404` — ImageNotFound
- `500` — InvalidIStockCollection

---

[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)