--- title: "Retrieve asset reports" url: "https://earlyaccess.developers.bynder.com/apis/analytics-api/versions/c50f3280-b9e2-4302-9d7f-6584d3ee7b84/paths/v7-analytics-api-v1-report-asset/get" --- > Full API specification: https://earlyaccess.developers.bynder.com/apis/analytics-api/versions/c50f3280-b9e2-4302-9d7f-6584d3ee7b84.md # Retrieve asset reports `GET` `/v7/analytics/api/v1/report/asset` 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. ## Query parameters - `limit` (integer, optional) - The maximum number of asset reports 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. - `fromDateCreated` (string, date-time, optional) - Retrieve reports of assets created after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds. - `toDateCreated` (string, date-time, optional) - Set a date range together with the "fromDateCreated" parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds. - `fromDateModified` (string, date-time, optional) - Retrieve reports of assets modified after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds. - `toDateModified` (string, date-time, optional) - Set a date range together with the "fromDateModified" 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/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. 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. 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. 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. in: query name: toDateModified required: false schema: format: date-time type: string responses: "200": content: application/json: examples: example-1: summary: Example response value: | [ { "assetId": "3DF53D46-4E72-47A0-A42ECC22CDE211D5", "name": "Asset 1", "description": "Asset Description", "isArchived": false, "type": "image", "audit": "ACCEPTED", "copyright": "", "isLimited": false, "datePublished": "2016-12-29T10:39:52.000+00:00", "isRemoved": true, "dateRemoved": "2019-01-04T13:19:47.000+00:00", "idHash": "6bb400d042cfe865", "phash": "56033317620", "userCreated": "00000000-0000-0000-0000000000000000", "dateCreated": "2018-12-21T13:11:46.000+00:00", "userModified": "00000000-0000-0000-0000000000000000", "dateModified": "2019-01-04T13:19:47.000+00:00", "isWatermarked": false, "isPublic": false }, { "assetId": "CD729A10-9101-47C7-9D14FA2E14CF28D9", "name": "Asset 2", "description": "Asset 2 description", "isArchived": false, "type": "image", "audit": "ACCEPTED", "copyright": "", "isLimited": false, "datePublished": "2019-03-31T23:55:21.000+00:00", "isRemoved": false, "idHash": "792e23855f02cdcb", "phash": "56033317620", "userCreated": "4BE80C1E-D8FF-4104-8CF774F06B1E60CE", "dateCreated": "2019-03-31T23:59:40.000+00:00", "userModified": "00000000-0000-0000-0000000000000000", "dateModified": "2020-12-04T21:18:27.000+00:00", "isWatermarked": false, "isPublic": false, "metaproperties": { "metaproperty_1": "option3", "metaproperty_2": "option2, option1", "metaproperty_3": "" } } ] 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 security: - permanentToken: - analytics.api:read - oauth2: - analytics.api:read components: securitySchemes: permanentToken: in: header name: Authorization type: apiKey ```