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

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

# Retrieve collection view events

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

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