Get history of binaries


Use this endpoint to get the change history details for a specific binary file.

curl --location --request POST '' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
    "accountId": 5153185,
    "serverHost": "3.0.1-ADM-060722",
    "filePath": "C:\\ProgramData\\Microsoft\\Windows Defender\\Definition Updates\\Backup\\mpasdlta.lkg",
    "startIndex": 0,
    "pageSize": 5
200 OK
    "error": null,
    "data": {
        "historyList": [{
            "history": [{
                "added": null,
                "removed": null,
                "type": "VERSION_CHANGE"
            "timestamp": 1655980690290
        }, {
            "history": [{
                "added": ["AES", "DSA", "RSA"],
                "removed": null,
                "type": "ALGO"
            "timestamp": 1654606828810
        "currentCount": 2,
        "totalCount": 2

Request parameters

Name Req/Opt Type Description
accountId required string Account ID.
serverHost required string The server host associated with the binary.
filePath required string The file path from where the binary is discovered.
startIndex optional integer Index of the first result.
pageSize optional integer Number of records per page.
Allowed values0 to 512

Response parameters

Name Type Description
error object Includes error codes, if any.
data object Object with information about the binary.
.. historyList object Object container for the history details.
.. .. history array List of the items that have changed in the file.
.. .. .. added array If any changes are added to the binary.
.. .. .. removed array If any changes are removed from the binary.
.. .. .. type string Type of changes that was made to the binary.
Allowed values: VERSION_CHANGE, ALGO
.. .. timestamp integer Date and time when the files changed.
.. currentCount integer Number of records on current page.
.. totalCount integer Total number of binaries that were changed.