Experiment with this API

Get Previous Downloads

Returns information about a customer's previously downloaded assets.

Quickstart

You'll need an API key and access token to use this resource. Please see our Getting Started page for more information on how to sign up for an API key. There are several SDKs available for popular programming languages to help you get started.

Use the following endpoint to retrieve metadata for multiple images:

GET https://api.gettyimages.com/v3/downloads

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 for more information on authorization tokens, and our Authorization Workflows for code examples of getting a token. To include your API token and a Bearer token to the header (example in curl):

-H "Api-Key: <your api key>"
-H "Authorization: Bearer <your-token>"

Your request would look like this using curl:

curl -X GET -H "Api-Key: <your api key>" -H "Authorization: Bearer <your-token>" https://api.gettyimages.com/v3/downloads

Your response will look like this:

{
  "result_count": 0,
  "downloads": [
    {
      "date_downloaded": "",
      "id": "",
      "product_type": "",
      "thumb_uri": "",
      "agreement_name": "",
      "download_details": {
        "download_notes": "",
        "project_code": ""
      }
    }
  ]
}

Your response will return a 200 - When successful.

Request Headers

Api-Key string Provide your API key. Required.
Authorization string Provide access token in the format of 'Bearer {token}'. Required.

Querystring Parameters

company_downloads boolean If specified, returns the list of previously downloaded images for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false.
date_from string If specified, select assets downloaded on or after this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD hh:mm:ss.sss). If time is omitted, midnight is assumed. Date/times are UTC.
date_to string If specified, select assets downloaded on or before this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD hh:mm:ss.sss). If time is omitted, midnight is assumed. Date/times are UTC.
product_type string Specifies product type to be included in the previous download results. Possible values: easyaccess editorialsubscription imagepack premiumaccess royaltyfreesubscription creditpack

Sorting and Pagination

page integer Identifies page to return. Default is 1.
page_size integer Specifies page size. Default is 30, maximum page_size is 100.

Response Body Fields

downloads_response

result_count integer Specifies the count of matching assets returned.
downloads array [ download ] Provides a list of download items.

download

date_downloaded string Specifies the date the asset was downloaded, in ISO 8601 format (e.g., 1999-12-31T00:00:00-00:00).
id string Specifies the unique identifier of the asset.
product_type string Specifies the license agreement applied to this download. Possible values are: premiumaccess, easyaccess, editorialsubscription, imagepack, royaltyfreesubscription, creditpack, sandbox.
thumb_uri string GET this URI to download the thumbnail.
agreement_name string Specifies the customer-defined name of the Premium Access agreement
download_details Customer stored details associated with this download.

DownloadDetails

download_notes string Associate a note with the download of an image.
project_code string Specifies the associated project code saved with the downloaded of an image.

Response Status Codes

200 OK
400 Bad request
400 InvalidRequest
400 InvalidRequest
401 AuthorizationTokenRequired
401 Unauthorized
403 Forbidden
403 InsufficientPermissions

Some response items contain hyperlinks which you can use to take you directly to the next steps in your workflow, when appropriate. The following URIs are provided in the response for this request.

download.thumb_uri string GET this URI to download the thumbnail.