---
title: "Retrieve asset usage"
url: "https://earlyaccess.developers.bynder.com/apis/asset-usage-api-1/versions/159163ba-c9a9-4c4d-a1ea-74c80ec6dea1/paths/api-media-usage/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/asset-usage-api-1/versions/159163ba-c9a9-4c4d-a1ea-74c80ec6dea1.md

# Retrieve asset usage

`GET` `/api/media/usage`

Retrieve asset usage information.

## Query parameters

- `asset_id` (string, optional) - Asset id.
- `integration_id` (string, optional) - Integration id.
- `uri` (string, optional) - URI.

## Responses

- `200` - Successful response
- `400` - Invalid request

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Asset Usage API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/media/usage:
    get:
      description: Retrieve asset usage information.
      parameters:
        - description: Asset id.
          in: query
          name: asset_id
          schema:
            type: string
        - description: Integration id.
          in: query
          name: integration_id
          schema:
            type: string
        - description: URI.
          in: query
          name: uri
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  properties:
                    additional:
                      type: string
                    asset_id:
                      type: string
                    id:
                      type: string
                    integration:
                      properties:
                        description:
                          type: string
                        id:
                          type: string
                      type: object
                    timestamp:
                      format: date-time
                      type: string
                    uri:
                      type: string
                  type: object
                type: array
          description: Successful response
        "400":
          content:
            application/json:
              schema:
                properties:
                  asset_id:
                    type: string
                type: object
          description: Invalid request
      summary: Retrieve asset usage
      tags:
        - Asset Usage
security:
  - OAuth2:
      - STATISTICS
  - permanentToken:
      - STATISTICS
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```