---
title: "Report usage of assets via a batch format."
method: PUT
path: "/v3/usage-batches/{id}"
tags: ["Usage"]
---

# Report usage of assets via a batch format.

`PUT /v3/usage-batches/{id}`

# 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.

## Path parameters

- `id` string, required

## Request body

- ReportUsageBatchRequest — Specifies the request information for the Batch Usages endpoint.
  - `asset_usages` AssetUsage[], nullable — Identifies the list of asset id, usage count and date of usage combinations to record.
    - `asset_id` string, nullable — Specifies the Id of the asset that was used.
    - `quantity` integer — Specifies the number of times the asset was used.
    - `usage_date` string, date-time — Identifies the date the asset was used, in ISO 8601 format (e.g., YYYY-MM-DD), time is not needed.

## Response `201`

Success - All usages reported were successfully recorded.

- ReportUsageBatchResponse — Specifies the response from the Batch Usages endpoint.
  - `invalid_assets` string[], nullable — Identifies a list of asset ids submitted that did not match known Getty asset ids.
  - `total_asset_usages_processed` integer, nullable — Specifies the number of asset usage records that were successfully recorded.

## Other responses

- `400` — InvalidRequest - The content of the request was invalid. Most commonly this is due to either too many assets specified, no assets or invalid JSON.
- `401` — AuthorizationTokenRequired - Authorization token was missing or not valid.
- `403` — UnauthorizedToReportUsage
- `409` — TransactionIdDuplicated

---

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