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

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

# Retrieve historical data in CSV format

`GET` `/v7/analytics/api/v1/historical/{year}.csv`

This endpoint provides historical Analytics data beyond the 12 month retention period that applies to the Analytics API endpoints.

## Path parameters

- `year` (string, required) - Year.

## 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/historical/{year}.csv:
    get:
      description: This endpoint provides historical Analytics data beyond the 12
        month retention period that applies to the Analytics API endpoints.
      parameters:
        - description: Year.
          in: path
          name: year
          required: true
          schema:
            example: "2022"
            type: string
      responses:
        "200":
          content:
            text/csv:
              examples:
                example-1:
                  summary: Example CSV response
                  value: |
                    asset.view,2023-03-25T07:26:09.739Z,1A84D758-2B3A-141F-8F07D71AA1F223BD,CA510292-E39E-4B28-AB6444CDD2B1C5C0,Product Insights,image,ACCEPTED,CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights,"","","","","","","","",""
                    user.login,2023-03-22T12:26:23.862Z,1A84D758-2B3A-141F-8F07D71AA1F223BD,"","","","","","","","","","","","","",""
                    SearchExecuted,2023-02-23T11:03:30.971Z,1A84D758-2B3A-141F-8F07D71AA1F223BD,"","","","","","","","",[de],"","","",{168}
          description: Successful response
      summary: Retrieve historical data in CSV format
      tags:
        - Historical Data
security:
  - permanentToken:
      - analytics.api:read
  - oauth2:
      - analytics.api:read
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```