Main Site HUB Security Scorecard API 2.3. Get Historical Overall Ratings for a Company

HUB

2.3. Get Historical Overall Ratings for a Company

Get Historical Overall Security Ratings for a Company

SecurityScorecard offers historical top level letter grade rating and score via API. This allows you to see how well the company has performed in the past as well as giving you insights into whether they are improving their security posture or getting worse.


Get the historical top level grades for a company

This API endpoint allows you to get the historical top level score for a company. You can check out the full specification for this endpoint here

Resource URI

/companies/{domain}/history/score?timing={timing}&from={from}&to={to}

Parameters:

Name Required Description
Domain Y The primary domain identifying a company in SecurityScorecard.
Timing Y The frequency of data. Valid options are: daily, weekly, monthly.
From Y The historical start date (2019-01-01)
To Y The historical end date (2019-08-01)

Sample Code:


            curl -X GET \
                https://api.securityscorecard.io/companies/ovofinance.com/history/score?timing=daily&from=2019-09-05&to=2019-09-12 \
                -H 'Accept: application/json' \
                -H 'Authorization: Token <Your API Key>' \
                -H 'Content-Type: application/json' \
                -H 'cache-control: no-cache'
        

Sample Response:


{
    "entries": [
        {
            "date": "2019-09-05T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-06T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-07T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-08T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-09T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-10T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-11T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        },
        {
            "date": "2019-09-12T00:00:00.000Z",
            "domain": "ovofinance.com",
            "score": 68
        }
    ]
}