Experiment with this API

Get Previously Purchased Assets

This endpoint returns a list of all assets purchased on gettyimages.com by the username used for authentication. Use of this endpoint requires configuration changes to your API key. Please contact developersupport@gettyimages.com to learn more.

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 return list of your previous purchases:

GET https://api.gettyimages.com/v3/purchased-assets

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/purchased-assets

The response body will look like the following example:

{
    "result_count": 0,
    "previous_purchases": [
        {
            "date_purchased": "",
            "asset_id": "",
            "asset_type": "",
            "license_model": "",
            "order_id": "",
            "thumb_uri": ""
        }
    ]
}

Request Headers

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

Querystring Parameters

date_from string If specified, retrieves previous purchases on or after this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD).
date_to string If specified, retrieves previous purchases on or before this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD).

Sorting and Pagination

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

Response Body Fields

PreviousAssetPurchases

result_count integer Count of previously purchased assets returned.
previous_purchases array [ PreviousAssetPurchase ] List of previously purchased assets.

PreviousAssetPurchase

date_purchased string Specifies the date the asset was downloaded, in ISO 8601 format (e.g., 1999-12-31T00:00:00-00:00).
asset_id string Specifies the unique identifier for the asset.
asset_type string Indicates the asset type classification. Possible values are: image, video.
license_model string Specifies the licensing model for the asset. Possible values are: royaltyfree, rightsmanaged, rightsready.
order_id string Specifies the purchase order id.
thumb_uri string GET this URI to download the thumbnail.

Response Status Codes

200 OK
400 PageNumberLessThanOne
400 PageSizeOutOfBounds
400 StartAndEndDateRequired
400 StartDateGreaterThanEndDateEvent
400 PageNumberGreaterThanMaxPages
401 Unauthorized

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.

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