GEgettyimages
Purchases

Get Previously Purchased Images and Video

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 your sales representative to learn more.

You'll need an API key and access token to use this resource.

get/v3/purchased-assets

Request

  • Base URL
    https://api.gettyimages.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Api-Key
    • or OAuth 2
      Authorization codehttps://authentication.gettyimages.com/oauth2/auth
      Client credentials
      Password
      Token URLhttps://authentication.gettyimages.com/oauth2/token
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

date_tostring date-time

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

pageinteger

Identifies page to return. Default is 1.

page_sizeinteger

Specifies page size. Default is 75, maximum page_size is 100.

date_fromstring date-time

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

company_purchasesboolean

If specified, returns the list of previously purchased assets 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.

Headers

Accept-Languagestring

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

OK

result_countinteger

Changes

No recorded changes to this operation across all 16 revisions of this API.