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

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

# Retrieve collection view events in CSV format

`GET` `/v7/analytics/api/v1/collection/views.csv`

## 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/collection/views.csv:
    get:
      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:
            text/csv:
              examples:
                example-1:
                  summary: Example CSV response
                  value: |
                    eventId,collectionId,eventType,dateTime,userId,isOwner,viewOrigin,ipAddress,userAgent,isBynderSupport
                    "ad3c8d01-4a2f-461c-b17d-2ecc51723028", "CA510292-E39E-4B28-AB6444CDD2B1C5C0", CollectionViewed, 2021-11-15T10:07:57.781+00:00, 1A84D758-2B3A-141F-8F07D71AA1F223BD, false, internal, 192.158.1.38, "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36", false
                    "ad3c8d01-4a2f-461c-b17d-2ecc51723028", "CA510292-E39E-4B28-AB6444CDD2B1C5C0", CollectionViewed, 2021-11-15T10:07:57.781+00:00,, false, embed, 192.158.1.38, "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36", false
          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 collection view events in CSV format
      tags:
        - Collection Usage
security:
  - permanentToken:
      - analytics.api:read
  - oauth2:
      - analytics.api:read
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```