v1

latestOpenAPI 3.0.42026-07-1376217536.1 KB

Usage

Report usage of assets via a batch format.

Report Usage

Use this endpoint to report the usages of a set of assets. The count of assets submitted in a single batch to this endpoint is limited to 1000. Note that all asset Ids specified must be valid or the operation will fail causing no usages to be recorded. In this case, you will need to remove the invalid asset Ids from the query request and re-submit the query.

Quickstart

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

Note: Date of use can be in any unambiguous date format.

put/v3/usage-batches/{id}

Path parameters

idstring required

Specifies a unique batch transaction id to identify the report.

Request body

Response

Success - All usages reported were successfully recorded.

invalid_assetsstring[] nullable

Identifies a list of asset ids submitted that did not match known Getty asset ids.

total_asset_usages_processedinteger nullable

Specifies the number of asset usage records that were successfully recorded.