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

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

# Retrieve search execution events

`GET` `/v7/analytics/api/v1/search/executions`

## 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 executions 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/search/executions:
    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 executions 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": "1408aec2-3114-43dd-be20-ffb1246a5231",
                        "eventType": "SearchExecuted",
                        "dateTime": "2021-11-15T10:07:57.781+00:00",
                        "userId": "1A84D758-2B3A-141F-8F07D71AA1F223BD",
                        "terms": ["digital"],
                        "filters": [{"field": "language", "value": "english"}],
                        "operator": "OR",
                        "sortOrder": {"field": "datePublished", "order": "desc"},
                        "results": {"assets": 48}
                      },
                      {
                        "eventId": "5908aec2-3114-43dd-be20-ffb1246a5231",
                        "eventType": "SearchExecuted",
                        "dateTime": "2021-11-15T10:07:57.781+00:00",
                        "userId": "1A84D758-2B3A-141F-8F07D71AA1F223BD",
                        "terms": ["template"],
                        "filters": [{"field": "language", "value": "spanish"}],
                        "operator": "OR",
                        "sortOrder": {"field": "datePublished", "order": "asc"},
                        "results": {"assets": 23}
                      }
                    ]
              schema:
                items:
                  properties:
                    dateTime:
                      example: 2021-11-15T10:07:57.781+00:00
                      format: date-time
                      type: string
                    eventId:
                      example: 1408aec2-3114-43dd-be20-ffb1246a5231
                      type: string
                    eventType:
                      example: SearchExecuted
                      type: string
                    filters:
                      items:
                        properties:
                          field:
                            example: language
                            type: string
                          value:
                            example: english
                            type: string
                        type: object
                      type: array
                    operator:
                      example: OR
                      type: string
                    results:
                      properties:
                        assets:
                          example: 48
                          type: integer
                      type: object
                    sortOrder:
                      properties:
                        field:
                          example: datePublished
                          type: string
                        order:
                          example: desc
                          type: string
                      type: object
                    terms:
                      example:
                        - digital
                      items:
                        type: string
                      type: array
                    userId:
                      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:
                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 search execution events
      tags:
        - Search Usage
security:
  - permanentToken:
      - analytics.api:read
  - oauth2:
      - analytics.api:read
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```