--- title: "Analytics API" url: "https://earlyaccess.developers.bynder.com/apis/analytics-api/versions/c50f3280-b9e2-4302-9d7f-6584d3ee7b84" --- # Analytics API OpenAPI specification document. ```json {"components":{"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"analytics.api:read":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"analytics.api:read":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"title":"Analytics API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v7/analytics/api/v1/asset/archive":{"get":{"description":"Retrieve archive events for assets within a specified date range.","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,"example":100,"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","example":"MTAwMA","type":"string"}},{"description":"Retrieve archive events occurred after this date.","in":"query","name":"fromDateTime","required":false,"schema":{"example":"2022-01-01T01:00:00.000Z","format":"date-time","type":"string"}},{"description":"Set a date range together with the \"fromDateTime\" parameter.","in":"query","name":"toDateTime","required":false,"schema":{"example":"2022-06-01T01:00:00.000Z","format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"asset.archive\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"asset.archive\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\",\n \"assetId\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1\",\n \"assetType\": \"image\",\n \"assetName\": \"Reporting Schedule Nov 2022\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetAudit":{"example":"ACCEPTED","type":"string"},"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"assetName":{"example":"Product Insights","type":"string"},"assetType":{"example":"image","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781Z","format":"date-time","type":"string"},"eventType":{"example":"asset.archive","type":"string"},"fileName":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","type":"string"},"id":{"example":"62de6d714e29485a81824fe3","type":"string"},"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":{"example":"MTAwMA","type":"string"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/archive?limit=1000&cursor=MTAwMA","type":"string"}}}}},"summary":"Retrieve asset archive events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/create":{"get":{"description":"Retrieve asset creation events within a specified date range.","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,"example":100,"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","example":"MTAwMA","type":"string"}},{"description":"Retrieve create events occurred after this date.","in":"query","name":"fromDateTime","required":false,"schema":{"example":"2022-01-01T01:00:00.000Z","format":"date-time","type":"string"}},{"description":"Set a date range together with the \"fromDateTime\" parameter.","in":"query","name":"toDateTime","required":false,"schema":{"example":"2022-06-01T01:00:00.000Z","format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"asset.create\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"asset.create\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\",\n \"assetId\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1\",\n \"assetType\": \"image\",\n \"assetName\": \"Reporting Schedule Nov 2022\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetAudit":{"example":"ACCEPTED","type":"string"},"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"assetName":{"example":"Product Insights","type":"string"},"assetType":{"example":"image","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781Z","format":"date-time","type":"string"},"eventType":{"example":"asset.create","type":"string"},"fileName":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","type":"string"},"id":{"example":"62de6d714e29485a81824fe3","type":"string"},"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":{"example":"MTAwMA","type":"string"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/create?limit=1000&cursor=MTAwMA","type":"string"}}}}},"summary":"Retrieve asset creation events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/download":{"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 download events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":[{"assetAudit":"ACCEPTED","assetId":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","assetName":"Product Insights","assetType":"image","dateTime":"2021-11-15T10:07:57.781+00:00","eventType":"asset.download","fileName":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","id":"62de6d714e29485a81824fe3","mediaItemId":"69293464-7721-4062-9E05EFAF23FE70E7","mediaItemType":"original","userId":"1A84D758-2B3A-141F-8F07D71AA1F223BD"},{"assetAudit":"ACCEPTED","assetId":"C58ED8C6-6B09-4CD6-B71C32C6715834F1","assetName":"Reporting Schedule Nov 2022","assetType":"image","dateTime":"2021-11-15T10:08:18.752+00:00","eventType":"asset.download","fileName":"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022","id":"62de6d714e29485a81824fe4","mediaItemId":"69293464-7721-4062-9E05EFAF23FE70E7","mediaItemType":"web","userId":"1A84D758-2B3A-141F-8F07D71AA1F223BD"}]}}},"text/csv":{"examples":{"example-1":{"summary":"Example CSV response","value":"id,eventType,userId,dateTime,assetId,assetType,assetName,assetAudit,fileName,mediaItemId,mediaItemType\n62de6d714e29485a81824fe3,asset.download,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655823377864,CA510292-E39E-4B28-AB6444CDD2B1C5C0,image,Product Insights,ACCEPTED,CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights,69293464-7721-4062-9E05EFAF23FE70E7,original\n62de6d714e29485a81824fe4,asset.download,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655996103781,C58ED8C6-6B09-4CD6-B71C32C6715834F1,image,Reporting Schedule Nov 2022,ACCEPTED,C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022,69293464-7721-4062-9E05EFAF23FE70E7,web\n"}}}},"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 asset download events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/remove":{"get":{"description":"Retrieve analytics events for removed assets.","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,"example":100,"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","example":"MTAwMA","type":"string"}},{"description":"Retrieve remove events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.","in":"query","name":"fromDateTime","required":false,"schema":{"example":"2022-01-01T01:00:00.000Z","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":{"example":"2022-06-01T01:00:00.000Z","format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"asset.remove\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"asset.remove\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\",\n \"assetId\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1\",\n \"assetType\": \"image\",\n \"assetName\": \"Reporting Schedule Nov 2022\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetAudit":{"example":"ACCEPTED","type":"string"},"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"assetName":{"example":"Product Insights","type":"string"},"assetType":{"example":"image","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781Z","format":"date-time","type":"string"},"eventType":{"example":"asset.remove","type":"string"},"fileName":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","type":"string"},"id":{"example":"62de6d714e29485a81824fe3","type":"string"},"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":{"example":"MTAwMA","type":"string"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/remove?limit=1000&cursor=MTAwMA","type":"string"}}}}},"summary":"Retrieve removed asset events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/v2/download":{"get":{"description":"This endpoint only offers data from 2023-11-01. Use the Asset Download endpoint for previous data.","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,"example":100,"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","example":"MTAwMA","type":"string"}},{"description":"Retrieve download events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","in":"query","name":"fromDateTime","required":false,"schema":{"example":"2022-01-01T01:00","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"example":"2022-06-01T01:00","format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"eventId\": \"1408aec2-3114-43dd-be20-ffb1246a5231\",\n \"eventType\": \"AssetDownloadRequested\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"downloadReasons\": [\n \"reason1\",\n \"reason2\"\n ]\n },\n {\n \"eventId\": \"5908aec2-3114-43dd-be20-ffb1246a5231\",\n \"eventType\": \"AssetDownloadRequested\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"assetId\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F\",\n \"downloadReasons\": [\n \"reason2\"\n ]\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"description":"Id of the asset","example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"description":"Date and time when the event occurred","example":"2021-11-15T10:07:57.781Z","format":"date-time","type":"string"},"downloadReasons":{"description":"Reasons given on why the asset was downloaded","example":["reason1","reason2"],"items":{"type":"string"},"type":"array"},"eventId":{"description":"Id of the event","example":"1408aec2-3114-43dd-be20-ffb1246a5231","type":"string"},"eventType":{"description":"Type of event","example":"AssetDownloadRequested","type":"string"},"userId":{"description":"Id of the user that generated the event","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":{"example":"MTAwMA","type":"string"}},"Next-Url":{"description":"The next url path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/v2/download?limit=1000&cursor=MTAwMA","type":"string"}}}}},"summary":"Retrieve asset download events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/view":{"get":{"description":"This endpoint will be deprecated on July, 15th. Use the Asset Views V2 endpoint instead.","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.\n","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":[{"assetAudit":"ACCEPTED","assetId":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","assetName":"Product Insights","assetType":"image","dateTime":"2021-11-15T10:07:57.781+00:00","eventType":"asset.view","fileName":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","id":"62de6d714e29485a81824fe3","userId":"1A84D758-2B3A-141F-8F07D71AA1F223BD"},{"assetAudit":"ACCEPTED","assetId":"C58ED8C6-6B09-4CD6-B71C32C6715834F1","assetName":"Reporting Schedule Nov 2022","assetType":"image","dateTime":"2021-11-15T10:08:18.752+00:00","eventType":"asset.view","fileName":"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022","id":"62de6d714e29485a81824fe4","userId":"1A84D758-2B3A-141F-8F07D71AA1F223BD"}]}}},"text/csv":{"examples":{"example-1":{"summary":"Example CSV response","value":"id,eventType,userId,dateTime,assetId,assetType,assetName,assetAudit,fileName\n62de6d714e29485a81824fe3,asset.view,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655823377864,CA510292-E39E-4B28-AB6444CDD2B1C5C0,image,Product Insights,ACCEPTED,CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\n62de6d714e29485a81824fe4,asset.view,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655996103781,C58ED8C6-6B09-4CD6-B71C32C6715834F1,image,Reporting Schedule Nov 2022,ACCEPTED,C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\n"}}}},"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 asset view events","tags":["Asset Usage V1"]}},"/v7/analytics/api/v1/asset/{assetId}":{"get":{"description":"This endpoint will allow you to retrieve all the events performed in a given asset.","parameters":[{"description":"Asset id.","in":"path","name":"assetId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"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,"example":100,"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","example":"MTAwMA","type":"string"}},{"description":"Retrieve events performed in a given asset occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.","in":"query","name":"fromDateTime","required":false,"schema":{"example":"2022-01-01T01:00","format":"date-time","type":"string"}},{"description":"Set a date range together with the \"fromDateTime\" parameter.","in":"query","name":"toDateTime","required":false,"schema":{"example":"2022-06-01T01:00","format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"asset.download\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\",\n \"mediaItemId\": \"69293464-7721-4062-9E05EFAF23FE70E7\",\n \"mediaItemType\": \"original\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"asset.view\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetAudit":{"example":"ACCEPTED","type":"string"},"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"assetName":{"example":"Product Insights","type":"string"},"assetType":{"example":"image","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventType":{"example":"asset.download","type":"string"},"fileName":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights","type":"string"},"id":{"example":"62de6d714e29485a81824fe3","type":"string"},"mediaItemId":{"example":"69293464-7721-4062-9E05EFAF23FE70E7","type":"string"},"mediaItemType":{"example":"original","type":"string"},"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":{"example":"MTAwMA","type":"string"}},"Next-Url":{"description":"The next url path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/CA510292-E39E-4B28-AB6444CDD2B1C5C0?limit=1000&cursor=MTAwMA","type":"string"}}}}},"summary":"Retrieve all events performed in a given asset","tags":["Asset Usage V1"]}},"/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.\n","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"eventId\": \"ad3c8d01-4a2f-461c-b17d-2ecc51723028\",\n \"collectionId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"eventType\": \"CollectionViewed\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"isOwner\": false,\n \"viewOrigin\": \"internal\",\n \"ipAddress\": \"192.158.1.38\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36\",\n \"isBynderSupport\": false\n },\n {\n \"eventId\": \"ad3c8d01-4a2f-461c-b17d-2ecc51723028\",\n \"collectionId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"eventType\": \"CollectionViewed\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"\",\n \"isOwner\": false,\n \"viewOrigin\": \"embed\",\n \"ipAddress\": \"192.158.1.38\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36\",\n \"isBynderSupport\": false\n }\n]\n"}},"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"]}},"/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.\n","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.\n","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\n\"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\n\"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\n"}}}},"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"]}},"/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,\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\"\nuser.login,2023-03-22T12:26:23.862Z,1A84D758-2B3A-141F-8F07D71AA1F223BD,\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\"\nSearchExecuted,2023-02-23T11:03:30.971Z,1A84D758-2B3A-141F-8F07D71AA1F223BD,\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",[de],\"\",\"\",\"\",{168}\n"}}}},"description":"Successful response"}},"summary":"Retrieve historical data in CSV format","tags":["Historical Data"]}},"/v7/analytics/api/v1/report/asset":{"get":{"description":"This endpoint allows you to retrieve a human readable report of any of the assets in the DAM. The report will include all the metadata of the asset.","parameters":[{"description":"The maximum number of asset reports 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 reports of assets created after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","in":"query","name":"fromDateCreated","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Set a date range together with the \"fromDateCreated\" parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","in":"query","name":"toDateCreated","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Retrieve reports of assets modified after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","in":"query","name":"fromDateModified","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Set a date range together with the \"fromDateModified\" parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","in":"query","name":"toDateModified","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"assetId\": \"3DF53D46-4E72-47A0-A42ECC22CDE211D5\",\n \"name\": \"Asset 1\",\n \"description\": \"Asset Description\",\n \"isArchived\": false,\n \"type\": \"image\",\n \"audit\": \"ACCEPTED\",\n \"copyright\": \"\",\n \"isLimited\": false,\n \"datePublished\": \"2016-12-29T10:39:52.000+00:00\",\n \"isRemoved\": true,\n \"dateRemoved\": \"2019-01-04T13:19:47.000+00:00\",\n \"idHash\": \"6bb400d042cfe865\",\n \"phash\": \"56033317620\",\n \"userCreated\": \"00000000-0000-0000-0000000000000000\",\n \"dateCreated\": \"2018-12-21T13:11:46.000+00:00\",\n \"userModified\": \"00000000-0000-0000-0000000000000000\",\n \"dateModified\": \"2019-01-04T13:19:47.000+00:00\",\n \"isWatermarked\": false,\n \"isPublic\": false\n },\n {\n \"assetId\": \"CD729A10-9101-47C7-9D14FA2E14CF28D9\",\n \"name\": \"Asset 2\",\n \"description\": \"Asset 2 description\",\n \"isArchived\": false,\n \"type\": \"image\",\n \"audit\": \"ACCEPTED\",\n \"copyright\": \"\",\n \"isLimited\": false,\n \"datePublished\": \"2019-03-31T23:55:21.000+00:00\",\n \"isRemoved\": false,\n \"idHash\": \"792e23855f02cdcb\",\n \"phash\": \"56033317620\",\n \"userCreated\": \"4BE80C1E-D8FF-4104-8CF774F06B1E60CE\",\n \"dateCreated\": \"2019-03-31T23:59:40.000+00:00\",\n \"userModified\": \"00000000-0000-0000-0000000000000000\",\n \"dateModified\": \"2020-12-04T21:18:27.000+00:00\",\n \"isWatermarked\": false,\n \"isPublic\": false,\n \"metaproperties\": {\n \"metaproperty_1\": \"option3\",\n \"metaproperty_2\": \"option2, option1\",\n \"metaproperty_3\": \"\"\n }\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"3DF53D46-4E72-47A0-A42ECC22CDE211D5","type":"string"},"audit":{"example":"ACCEPTED","type":"string"},"copyright":{"example":"","type":"string"},"dateCreated":{"example":"2018-12-21T13:11:46.000+00:00","format":"date-time","type":"string"},"dateModified":{"example":"2019-01-04T13:19:47.000+00:00","format":"date-time","type":"string"},"datePublished":{"example":"2016-12-29T10:39:52.000+00:00","format":"date-time","type":"string"},"dateRemoved":{"example":"2019-01-04T13:19:47.000+00:00","format":"date-time","type":"string"},"description":{"example":"Asset Description","type":"string"},"idHash":{"example":"6bb400d042cfe865","type":"string"},"isArchived":{"example":false,"type":"boolean"},"isLimited":{"example":false,"type":"boolean"},"isPublic":{"example":false,"type":"boolean"},"isRemoved":{"example":true,"type":"boolean"},"isWatermarked":{"example":false,"type":"boolean"},"metaproperties":{"additionalProperties":{"type":"string"},"example":{"metaproperty_1":"option3","metaproperty_2":"option2, option1","metaproperty_3":""},"type":"object"},"name":{"example":"Asset 1","type":"string"},"phash":{"example":"56033317620","type":"string"},"type":{"example":"image","type":"string"},"userCreated":{"example":"00000000-0000-0000-0000000000000000","type":"string"},"userModified":{"example":"00000000-0000-0000-0000000000000000","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 asset reports","tags":["Reporting"]}},"/v7/analytics/api/v1/report/asset/{assetId}":{"get":{"description":"This endpoint allows you to retrieve a human readable report for a specific asset in the DAM. The report will include all the metadata of the asset.","parameters":[{"description":"Asset id.","in":"path","name":"assetId","required":true,"schema":{"example":"CD729A10-9101-47C7-9D14FA2E14CF28D9","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"{\n \"assetId\": \"CD729A10-9101-47C7-9D14FA2E14CF28D9\",\n \"name\": \"Asset 2\",\n \"description\": \"Asset 2 description\",\n \"isArchived\": false,\n \"type\": \"image\",\n \"audit\": \"ACCEPTED\",\n \"copyright\": \"\",\n \"isLimited\": false,\n \"datePublished\": \"2019-03-31T23:55:21.000+00:00\",\n \"isRemoved\": false,\n \"idHash\": \"792e23855f02cdcb\",\n \"phash\": \"56033317620\",\n \"userCreated\": \"4BE80C1E-D8FF-4104-8CF774F06B1E60CE\",\n \"dateCreated\": \"2019-03-31T23:59:40.000+00:00\",\n \"userModified\": \"00000000-0000-0000-0000000000000000\",\n \"dateModified\": \"2020-12-04T21:18:27.000+00:00\",\n \"isWatermarked\": false,\n \"isPublic\": false,\n \"metaproperties\": {\n \"metaproperty_1\": \"option3\",\n \"metaproperty_2\": \"option2, option1\",\n \"metaproperty_3\": \"\"\n }\n}\n"}},"schema":{"properties":{"assetId":{"example":"CD729A10-9101-47C7-9D14FA2E14CF28D9","type":"string"},"audit":{"example":"ACCEPTED","type":"string"},"copyright":{"example":"","type":"string"},"dateCreated":{"example":"2019-03-31T23:59:40.000+00:00","format":"date-time","type":"string"},"dateModified":{"example":"2020-12-04T21:18:27.000+00:00","format":"date-time","type":"string"},"datePublished":{"example":"2019-03-31T23:55:21.000+00:00","format":"date-time","type":"string"},"description":{"example":"Asset 2 description","type":"string"},"idHash":{"example":"792e23855f02cdcb","type":"string"},"isArchived":{"example":false,"type":"boolean"},"isLimited":{"example":false,"type":"boolean"},"isPublic":{"example":false,"type":"boolean"},"isRemoved":{"example":false,"type":"boolean"},"isWatermarked":{"example":false,"type":"boolean"},"metaproperties":{"additionalProperties":{"type":"string"},"example":{"metaproperty_1":"option3","metaproperty_2":"option2, option1","metaproperty_3":""},"type":"object"},"name":{"example":"Asset 2","type":"string"},"phash":{"example":"56033317620","type":"string"},"type":{"example":"image","type":"string"},"userCreated":{"example":"4BE80C1E-D8FF-4104-8CF774F06B1E60CE","type":"string"},"userModified":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},"type":"object"}}},"description":"Successful response"}},"summary":"Retrieve specific asset report","tags":["Reporting"]}},"/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":"[\n {\n \"eventId\": \"1408aec2-3114-43dd-be20-ffb1246a5231\",\n \"eventType\": \"SearchExecuted\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"terms\": [\"digital\"],\n \"filters\": [{\"field\": \"language\", \"value\": \"english\"}],\n \"operator\": \"OR\",\n \"sortOrder\": {\"field\": \"datePublished\", \"order\": \"desc\"},\n \"results\": {\"assets\": 48}\n },\n {\n \"eventId\": \"5908aec2-3114-43dd-be20-ffb1246a5231\",\n \"eventType\": \"SearchExecuted\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"terms\": [\"template\"],\n \"filters\": [{\"field\": \"language\", \"value\": \"spanish\"}],\n \"operator\": \"OR\",\n \"sortOrder\": {\"field\": \"datePublished\", \"order\": \"asc\"},\n \"results\": {\"assets\": 23}\n }\n]\n"}},"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"]}},"/v7/analytics/api/v1/search/keyword":{"get":{"description":"Deprecated. Use the Search Executions endpoint instead.","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 keyword 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":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"search.keyword\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"keyword\": \"digital templates\",\n \"totalResults\": 27,\n \"tagsResults\": 0,\n \"assetsResults\": 24,\n \"documentsResults\": 0,\n \"guidelinesResults\": 0,\n \"collectionsResults\": 3,\n \"metapropertiesResults\": 0,\n \"collectionAssetsResults\": 0,\n \"workflowCampaignsResults\": 0,\n \"brandstoreProductsResults\": 0\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"search.keyword\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"keyword\": \"assets\",\n \"totalResults\": 56,\n \"tagsResults\": 0,\n \"assetsResults\": 48,\n \"documentsResults\": 0,\n \"guidelinesResults\": 0,\n \"collectionsResults\": 8,\n \"metapropertiesResults\": 0,\n \"collectionAssetsResults\": 0,\n \"workflowCampaignsResults\": 0,\n \"brandstoreProductsResults\": 0\n }\n]\n"}},"schema":{"items":{"properties":{"assetsResults":{"example":24,"type":"integer"},"brandstoreProductsResults":{"example":0,"type":"integer"},"collectionAssetsResults":{"example":0,"type":"integer"},"collectionsResults":{"example":3,"type":"integer"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"documentsResults":{"example":0,"type":"integer"},"eventType":{"example":"search.keyword","type":"string"},"guidelinesResults":{"example":0,"type":"integer"},"id":{"example":"62de6d714e29485a81824fe3","type":"string"},"keyword":{"example":"digital templates","type":"string"},"metapropertiesResults":{"example":0,"type":"integer"},"tagsResults":{"example":0,"type":"integer"},"totalResults":{"example":27,"type":"integer"},"userId":{"example":"1A84D758-2B3A-141F-8F07D71AA1F223BD","type":"string"},"workflowCampaignsResults":{"example":0,"type":"integer"}},"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 keyword events","tags":["Search Usage"]}},"/v7/analytics/api/v1/search/keyword.csv":{"get":{"description":"Deprecated. Use the Search Executions endpoint instead.","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 keyword 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":"id,eventType,userId,dateTime,keyword,totalResults,tagsResults,assetsResults,documentsResults,guidelinesResults,collectionsResults,metapropertiesResults,collectionAssetsResults,workflowCampaignsResults,brandstoreProductsResults\n62de6d714e29485a81824fe3,search.keyword,\"1A84D758-2B3A-141F-8F07D71AA1F223BD\",1655823377864,\"digital templates\",27,0,24,0,0,3,0,0,0,0\n62de6d714e29485a81824fe4,search.keyword,\"1A84D758-2B3A-141F-8F07D71AA1F223BD\",1655996103781,digital,56,0,48,0,0,8,0,0,0,0,0\n"}}}},"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 keyword events in CSV format","tags":["Search Usage"]}},"/v7/analytics/api/v1/user/login":{"get":{"description":"Retrieve login events.","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 login events occurred after this date. ISO8601 format: yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"user.login\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"user.login\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\"\n }\n]\n"}}},"text/csv":{"examples":{"example-1":{"summary":"Example CSV response","value":"id,eventType,userId,dateTime\n62de6d714e29485a81824fe3,user.login,\"1A84D758-2B3A-141F-8F07D71AA1F223BD\",1655823377864\n62de6d714e29485a81824fe4,user.login,\"1A84D758-2B3A-141F-8F07D71AA1F223BD\",1655996103781\n"}}}},"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":"User Login","tags":["User Usage"]}},"/v7/analytics/api/v1/user/{userId}":{"get":{"description":"Retrieve all the events triggered by a given user.","parameters":[{"description":"User id.","in":"path","name":"userId","required":true,"schema":{"example":"00000000-0000-0000-0000000000000000","type":"string"}},{"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":"MDow","type":"string"}},{"description":"Retrieve events triggered by a user occurred after this date. ISO8601 format: yyyy-mm-ddThh:mm[:ssZ] with optional seconds.\n","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.\n","in":"query","name":"toDateTime","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"example-1":{"summary":"Example response","value":"[\n {\n \"id\": \"62de6d714e29485a81824fe3\",\n \"eventType\": \"asset.download\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"assetType\": \"image\",\n \"assetName\": \"Product Insights\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights\",\n \"mediaItemId\": \"69293464-7721-4062-9E05EFAF23FE70E7\",\n \"mediaItemType\": \"original\"\n },\n {\n \"id\": \"62de6d714e29485a81824fe4\",\n \"eventType\": \"asset.view\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:08:18.752+00:00\",\n \"assetId\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1\",\n \"assetType\": \"image\",\n \"assetName\": \"Reporting Schedule Nov 2022\",\n \"assetAudit\": \"ACCEPTED\",\n \"fileName\": \"C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\"\n }\n]\n"}}},"text/csv":{"examples":{"example-1":{"summary":"Example CSV response","value":"id,eventType,userId,dateTime,assetId,assetType,assetName,assetAudit,fileName,mediaItemId,mediaItemType\n62de6d714e29485a81824fe3,asset.download,\"1A84D758-2B3A-141F-8F07D71AA1F223BD\",1655823377864,\"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",image,Product Insights,ACCEPTED,CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights,69293464-7721-4062-9E05EFAF23FE70E7,original\n62de6d714e29485a81824fe4,asset.view,1A84D758-2B3A-141F-8F07D71AA1F223BD,1655996103781,C58ED8C6-6B09-4CD6-B71C32C6715834F1,image,Reporting Schedule Nov 2022,ACCEPTED,C58ED8C6-6B09-4CD6-B71C32C6715834F1___Reporting Schedule Nov 2022\n"}}}},"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":"User Activity","tags":["User Usage"]}},"/v7/analytics/api/v2/asset/archives":{"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":0,"type":"integer"}},{"description":"Retrieve archive 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":"[\n {\n \"eventId\": \"536280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetArchived\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"536280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetArchived","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/asset/archives?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset archives","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/asset/creations":{"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":0,"type":"integer"}},{"description":"Retrieve creation 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":"[\n {\n \"eventId\": \"336280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetCreated\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"336280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetCreated","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/asset/creations?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset creations","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/asset/deletions":{"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":0,"type":"integer"}},{"description":"Retrieve deletion 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":"[\n {\n \"eventId\": \"636280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetDeleted\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"fileIds\": \"file-id-1,file-id-2\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"636280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetDeleted","type":"string"},"fileIds":{"description":"Comma-separated list of file IDs.","example":"file-id-1,file-id-2","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/asset/deletions?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset deletions","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/asset/downloads":{"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":0,"type":"integer"}},{"description":"Retrieve download 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":"[\n {\n \"eventId\": \"236280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetDownloaded\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\",\n \"mediaItemIds\": [\"media-item-1\", \"media-item-2\"],\n \"downloadReasons\": [\"personal_use\", \"marketing\"]\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"downloadReasons":{"example":["personal_use","marketing"],"items":{"type":"string"},"type":"array"},"eventId":{"example":"236280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetDownloaded","type":"string"},"mediaItemIds":{"example":["media-item-1","media-item-2"],"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/asset/downloads?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset downloads","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/asset/removes":{"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":0,"type":"integer"}},{"description":"Retrieve remove 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":"[\n {\n \"eventId\": \"436280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetRemoved\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"436280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetRemoved","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/asset/removes?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset removes","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/asset/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":0,"type":"integer"}},{"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":"[\n {\n \"eventId\": \"236280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"AssetViewed\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\"\n },\n {\n \"eventId\": \"236280dd-b06e-44be-ae9f-85e2661510a2\",\n \"eventType\": \"AssetViewed\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-16T07:13:46.781+00:00\",\n \"assetId\": \"CA510292-E39E-4B28-AB6444CDD2B1C5C0\"\n }\n]\n"}},"schema":{"items":{"properties":{"assetId":{"example":"CA510292-E39E-4B28-AB6444CDD2B1C5C0","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"236280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"AssetViewed","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/api/v1/asset/view?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve asset views","tags":["Asset Usage V2"]}},"/v7/analytics/api/v2/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":0,"type":"integer"}},{"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":"[\n {\n \"eventId\": \"936280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"CollectionViewed\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"collectionId\": \"DA621393-F40F-5C39-BC7555DEE3C2D6D1\",\n \"isOwner\": true,\n \"viewOrigin\": \"portal\",\n \"userAgent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)\",\n \"isBynderSupport\": false\n }\n]\n"}},"schema":{"items":{"properties":{"collectionId":{"example":"DA621393-F40F-5C39-BC7555DEE3C2D6D1","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"936280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"CollectionViewed","type":"string"},"isBynderSupport":{"example":false,"type":"boolean"},"isOwner":{"example":true,"type":"boolean"},"userAgent":{"example":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)","type":"string"},"userId":{"example":"1A84D758-2B3A-141F-8F07D71AA1F223BD","type":"string"},"viewOrigin":{"example":"portal","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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/collection/views?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve collection views","tags":["Collection Usage"]}},"/v7/analytics/api/v2/user/creations":{"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":0,"type":"integer"}},{"description":"Retrieve creation 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":"[\n {\n \"eventId\": \"836280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"UserCreated\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\",\n \"createdUserId\": \"2B95E869-3C4B-252G-9G18E82BB2G334CE\",\n \"eventCount\": 1,\n \"source\": \"portal\"\n }\n]\n"}},"schema":{"items":{"properties":{"createdUserId":{"example":"2B95E869-3C4B-252G-9G18E82BB2G334CE","type":"string"},"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventCount":{"example":1,"type":"integer"},"eventId":{"example":"836280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"UserCreated","type":"string"},"source":{"example":"portal","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/user/creations?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve user creations","tags":["User Usage"]}},"/v7/analytics/api/v2/user/logins":{"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":0,"type":"integer"}},{"description":"Retrieve login 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":"[\n {\n \"eventId\": \"736280dd-b06e-44be-ae9f-85e2661510a1\",\n \"eventType\": \"UserLogin\",\n \"userId\": \"1A84D758-2B3A-141F-8F07D71AA1F223BD\",\n \"dateTime\": \"2021-11-15T10:07:57.781+00:00\"\n }\n]\n"}},"schema":{"items":{"properties":{"dateTime":{"example":"2021-11-15T10:07:57.781+00:00","format":"date-time","type":"string"},"eventId":{"example":"736280dd-b06e-44be-ae9f-85e2661510a1","type":"string"},"eventType":{"example":"UserLogin","type":"string"},"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":{"example":1000,"type":"integer"}},"Next-Url":{"description":"The next URL path to query if you want to continue with your paginated request.","schema":{"example":"/v7/analytics/api/v2/user/logins?limit=1000&cursor=1000","type":"string"}}}}},"summary":"Retrieve user logins","tags":["User Usage"]}}},"security":[{"permanentToken":["analytics.api:read"]},{"oauth2":["analytics.api:read"]}],"servers":[{"url":"https://{your-bynder-domain}"}],"tags":[{"description":"These endpoints return information related to the specific event. You can enrich these events with specific data about the asset or the user by making use of the [Analytics Reporting tool](#reference/analytics/reporting) or the [Users API endpoints](#reference/users).\nThis new version resolves pagination performance issues.\n","name":"Asset Usage V2"},{"description":"These endpoints return information related to the specific event. You can enrich these events with specific data about the asset or the user by making use of the [Analytics Reporting tool](#reference/analytics/reporting) or the [Users API endpoints](#reference/users).\n","name":"Asset Usage V1"},{"description":"These endpoints return information related to the specific event. You can enrich these events with specific data about the asset or the user by making use of the [Assets API endpoints](#reference/assets) or the [Users API endpoints](#reference/users).\n","name":"Search Usage"},{"description":"These endpoints return information related to the specific event. You can enrich these events with specific data about the asset or the user by making use of the [Assets API endpoints](#reference/assets) or the [Users API endpoints](#reference/users).\n","name":"User Usage"},{"description":"These endpoints return information related to the specific event. You can enrich these events with specific data about the collection or the user by making use of the [Collections API endpoints](#reference/collections) or the [Users API endpoints](#reference/users).\n","name":"Collection Usage"},{"description":"These endpoints provide reporting capabilities for assets of the DAM, making it easier to build your own customised reports.\n","name":"Reporting"},{"description":"This endpoint provides historical Analytics data beyond the 12 month retention period that applies to the Analytics API endpoints. **Note:** This data isn't available by default. Please, contact your CSM if you require access to it.\n","name":"Historical Data"}]} ```