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

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

# Retrieve asset download events

`GET` `/v7/analytics/api/v1/asset/v2/download`

This endpoint only offers data from 2023-11-01. Use the Asset Download endpoint for previous data.

## 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 download 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/v2/download:
    get:
      description: This endpoint only offers data from 2023-11-01. Use the Asset
        Download endpoint for previous data.
      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
            example: 100
            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
            example: MTAwMA
            type: string
        - description: >
            Retrieve download events occurred after this date. ISO8601 format
            yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
          in: query
          name: fromDateTime
          required: false
          schema:
            example: 2022-01-01T01:00
            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:
            example: 2022-06-01T01:00
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  summary: Example response
                  value: |
                    [
                      {
                        "eventId": "1408aec2-3114-43dd-be20-ffb1246a5231",
                        "eventType": "AssetDownloadRequested",
                        "dateTime": "2021-11-15T10:07:57.781+00:00",
                        "userId": "1A84D758-2B3A-141F-8F07D71AA1F223BD",
                        "assetId": "CA510292-E39E-4B28-AB6444CDD2B1C5C0",
                        "downloadReasons": [
                          "reason1",
                          "reason2"
                        ]
                      },
                      {
                        "eventId": "5908aec2-3114-43dd-be20-ffb1246a5231",
                        "eventType": "AssetDownloadRequested",
                        "dateTime": "2021-11-15T10:07:57.781+00:00",
                        "userId": "1A84D758-2B3A-141F-8F07D71AA1F223BD",
                        "assetId": "C58ED8C6-6B09-4CD6-B71C32C6715834F",
                        "downloadReasons": [
                          "reason2"
                        ]
                      }
                    ]
              schema:
                items:
                  properties:
                    assetId:
                      description: Id of the asset
                      example: CA510292-E39E-4B28-AB6444CDD2B1C5C0
                      type: string
                    dateTime:
                      description: Date and time when the event occurred
                      example: 2021-11-15T10:07:57.781Z
                      format: date-time
                      type: string
                    downloadReasons:
                      description: Reasons given on why the asset was downloaded
                      example:
                        - reason1
                        - reason2
                      items:
                        type: string
                      type: array
                    eventId:
                      description: Id of the event
                      example: 1408aec2-3114-43dd-be20-ffb1246a5231
                      type: string
                    eventType:
                      description: Type of event
                      example: AssetDownloadRequested
                      type: string
                    userId:
                      description: Id of the user that generated the event
                      example: 1A84D758-2B3A-141F-8F07D71AA1F223BD
                      type: string
                  type: object
                type: array
          description: Successful response
          headers:
            Next-Cursor:
              description: The next cursor value to send if you want to continue with your
                paginated request.
              schema:
                example: MTAwMA
                type: string
            Next-Url:
              description: The next url path to query if you want to continue with your
                paginated request.
              schema:
                example: /api/v1/asset/v2/download?limit=1000&cursor=MTAwMA
                type: string
      summary: Retrieve asset download events
      tags:
        - Asset Usage V1
security:
  - permanentToken:
      - analytics.api:read
  - oauth2:
      - analytics.api:read
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```