Get MetaDefender Core Reports
| API version | 1.0 |
|---|---|
| Last Update | 06/17/2025 |
| Authentication | YES |
| HTTP Method | POST |
| Content Type | application/json |
| Rate limited | YES |
| Requests per rate limit | 10/min |
| Response Format | JSON |
Retrieve MetaDefender Core's processing history reports in the cursor fashion, sorted by enrollment time in ascending order.
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| Authorization | string | Header | Yes | Bearer token for Authentication Authorization: Bearer ACCESS_TOKEN | |
| token | string | Body | Optional | Specify a pagination token that devices will be returned in. It can be used to return the next set of items in the list. Return the oldest items in case the token is missing. | |
| limit | int | Body | Optional | Specify maximum number of devices will be returned in the response. The value should be in [1,100]. | 20 |
| start_time | long | Body | Yes | Specify a start time of the query's duration. The format should be Unix epoch time in milliseconds The value must be greater than zero, and it must not be more than 30 days from the current date. | |
| end_time | long | Body | Optional | Specify an end time of the query's duration. The format should be Unix epoch time in milliseconds | |
| filter | object | Body | Optional | Specify filter criteria | |
| filter.deployment_id | array<string> | Body | Optional | List of deployment ID |
Notes:
- criteria in a same parameter will be combined with OR operator
- criteria in different parameter will be combined with AND operator
Response HTTP Code
See details in the Response HTTP Code section in this page
Response Parameters
| Key | DataType | Description |
|---|---|---|
| token | string | A pagination token. |
| data | Array Object | The returned reports. |
| data.timestamp | long | timestamp when the report occurs |
| data.user | string | MD Core's user associated with an API Key used to scan the file |
| data.file_name | string | file name |
| data.status | string | status |
| data.result | string | result |
| data.data_id | string | |
| data.parent_data_id | string | |
| data.workflow | string | workflow |
| data.sha256 | string | sha256 of the file |
| data.deployment_id | string | deployment ID |
| data.incident_types | Array<string> | |
| data.verdicts | Array<string> | |
| data.actions | Array<string> | |
| data.parent_session_ids | Array<string> |
Example
Example Request
Example Response
Was this page helpful?