---
title: "Retrieve asset view events"
url: "https://earlyaccess.developers.bynder.com/apis/analytics-api/versions/c50f3280-b9e2-4302-9d7f-6584d3ee7b84/paths/v7-analytics-api-v1-asset-view/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/analytics-api/versions/c50f3280-b9e2-4302-9d7f-6584d3ee7b84.md

# Retrieve asset view events

`GET` `/v7/analytics/api/v1/asset/view`

This endpoint will be deprecated on July, 15th. Use the Asset Views V2 endpoint instead.

## Query parameters

- `limit` (integer, optional) - The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.
- `cursor` (string, optional) - Cursor mark returned in the response headers to be used for pagination purposes.
- `fromDateTime` (string, date-time, optional) - Retrieve view events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
- `toDateTime` (string, date-time, optional) - Set a date range together with the "fromDateTime" parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Analytics API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /v7/analytics/api/v1/asset/view:
    get:
      description: This endpoint will be deprecated on July, 15th. Use the Asset Views
        V2 endpoint instead.
      parameters:
        - description: The maximum number of analytics events to retrieve. Allowed values
            are between 1 and 10000.
          in: query
          name: limit
          required: false
          schema:
            default: 1000
            type: integer
        - description: Cursor mark returned in the response headers to be used for
            pagination purposes.
          in: query
          name: cursor
          required: false
          schema:
            default: MA
            type: string
        - description: >
            Retrieve view events occurred after this date. ISO8601 format
            yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
          in: query
          name: fromDateTime
          required: false
          schema:
            format: date-time
            type: string
        - description: >
            Set a date range together with the "fromDateTime" parameter. ISO8601
            format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
          in: query
          name: toDateTime
          required: false
          schema:
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  summary: Example response
                  value:
                    - assetAudit: ACCEPTED
                      assetId: CA510292-E39E-4B28-AB6444CDD2B1C5C0
                      assetName: Product Insights
                      assetType: image
                      dateTime: 2021-11-15T10:07:57.781+00:00
                      eventType: asset.view
                      fileName: CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights
                      id: 62de6d714e29485a81824fe3
                      userId: 1A84D758-2B3A-141F-8F07D71AA1F223BD
                    - assetAudit: ACCEPTED
                      assetId: C58ED8C6-6B09-4CD6-B71C32C6715834F1
                      assetName: Reporting Schedule Nov 2022
                      assetType: image
                      dateTime: 2021-11-15T10:08:18.752+00:00
                      eventType: asset.view
                      fileName: C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022
                      id: 62de6d714e29485a81824fe4
                      userId: 1A84D758-2B3A-141F-8F07D71AA1F223BD
            text/csv:
              examples:
                example-1:
                  summary: Example CSV response
                  value: |
                    id,eventType,userId,dateTime,assetId,assetType,assetName,assetAudit,fileName
                    62de6d714e29485a81824fe3,asset.view,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655823377864,CA510292-E39E-4B28-AB6444CDD2B1C5C0,image,Product Insights,ACCEPTED,CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights
                    62de6d714e29485a81824fe4,asset.view,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655996103781,C58ED8C6-6B09-4CD6-B71C32C6715834F1,image,Reporting Schedule Nov 2022,ACCEPTED,C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022
          description: Successful response
          headers:
            Next-Cursor:
              description: The next cursor value to send if you want to continue with your
                paginated request.
              schema:
                type: string
            Next-Url:
              description: The next url path to query if you want to continue with your
                paginated request.
              schema:
                type: string
      summary: Retrieve asset view events
      tags:
        - Asset Usage V1
security:
  - permanentToken:
      - analytics.api:read
  - oauth2:
      - analytics.api:read
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```
