---
title: "Returns information about a customer's downloaded assets."
method: GET
path: "/v3/downloads"
tags: ["Downloads"]
---

# Returns information about a customer's downloaded assets.

`GET /v3/downloads`

Returns information about a customer's previously downloaded assets.

You'll need an API key and access token to use this resource.
 
	
This endpoint requires being a Getty Images customer to limit your results to only assets that you have a license to use, 
you need to also include an authorization token in the header of your request. 
Please consult our [Authorization FAQ](http://developers.gettyimages.com/en/authorization-faq.html) for more information on authorization tokens.

## Query parameters

- `date_from` string, date-time
- `date_to` string, date-time
- `use_time` boolean
- `page` integer
- `page_size` integer
- `product_type` 'easyaccess' | 'editorialsubscription' | 'imagepack' | 'premiumaccess' | 'royaltyfreesubscription' | 'creditpack' | 'aigen'
- `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

- GettyImagesServicesConnectPublicModelsDownloadsGetDownloadsResponse
  - `result_count` integer
  - `downloads` GettyImagesServicesConnectPublicModelsDownloadsHistoricalDownload[], nullable
    - `date_downloaded` string, date-time
    - `id` string, nullable
    - `asset_type` string, nullable
    - `product_type` string, nullable
    - `thumb_uri` string, nullable
    - `agreement_name` string, nullable
    - `product_id` integer
    - `download_details` GettyImagesServicesConnectPublicModelsDownloadsDownloadDetails
      - `download_notes` string, nullable
      - `project_code` string, nullable
    - `download_source` string, nullable
    - `user` GettyImagesServicesConnectPublicModelsDownloadsUser
      - `username` string, nullable
      - `first_name` string, nullable
      - `middle_name` string, nullable
      - `last_name` string, nullable
    - `size_name` string, nullable
    - `dimensions` GettyImagesServicesConnectPublicModelsDownloadsDimensions
      - `width` integer, nullable
      - `height` integer, nullable
      - `dpi` integer, nullable
    - `license_model` string, nullable
    - `generated_asset_id` string, nullable

## Other responses

- `400` — Bad request
- `401` — AuthorizationTokenRequired
- `403` — Forbidden

---

[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/29f239eeae86/schema)