---
title: "Retrieve asset usage"
method: GET
path: "/api/media/usage"
tags: ["Asset Usage"]
---

# Retrieve asset usage

`GET /api/media/usage`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/media/usage`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `STATISTICS`
  - API key in header `Authorization`

Retrieve asset usage information.

## Query parameters

- `asset_id` string
- `integration_id` string
- `uri` string

## Response `200`

Successful response

- object[]
  - `asset_id` string
  - `id` string
  - `integration` object
    - `id` string
    - `description` string
  - `timestamp` string, date-time
  - `uri` string
  - `additional` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/bynder/apis/asset-usage-api.md) - [All operations](https://skmtc.dev/bynder/apis/asset-usage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/asset-usage-api/revisions/84b7da938753?raw)