# Asset Download Events

An [`Asset Download Event Search`](#operation/postAssetDownloadEventSearch) allows you to search and aggregate over `Asset Download Events`      

Criteria can be constructed based on exact or ranged comparison of the queryable event fields listed in the request schema below. 
Some fields like `USER_TYPE` and `DOWNLOAD_TYPE` have a fixed set of possible values which can be determined from the response scheme below.    
      
The logical operators `AND`, `OR` and `NOT` are provided to support complex queries based on multiple fields.

A list of sorts can also be provided to control the order in the which the results are returned.

Only the ids of referenced resources such as [`Portal`](#tag/Portals) and [`Asset`](#tag/Assets) are provided in the response, which can then be used to GET the full resources.         

Aggregations operations can also be performed on the events described by the criteria, in order to, for example
- Search across all downloads and count the number of downloads for each asset
- Search downloads for a specific user and count the number of downloads per month

Note, an [`Asset Download Event Search`](#operation/postAssetDownloadEventSearch) will only allow you to page to **10,000** but values returned in any aggregations and the `totalResults` property will be correct.


## Search for asset download events

 - [POST /asset-download-event-searches](https://api-docs.dash.app/dash/openapi/asset-download-events/postassetdownloadeventsearch.md): Create a new Asset Download Event Search