Main Site HUB Security Scorecard API 2.4 Get Historical Factor Level Ratings for a company

HUB

2.4 Get Historical Factor Level Ratings for a company

Get Historical Factor Security Ratings for a Company

SecurityScorecard offers historical factor 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 factor level grades for a company

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

Resource URI

/companies/{domain}/history/factors/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/factors/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",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 87
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 75
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 68
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-06T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 87
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 75
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 68
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-07T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 68
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-08T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 68
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-09T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 67
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-10T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 49
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 67
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-11T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 51
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 67
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        },
        {
            "date": "2019-09-12T00:00:00.000Z",
            "domain": "ovofinance.com",
            "factors": [
                {
                    "name": "application_security",
                    "score": 37
                },
                {
                    "name": "cubit_score",
                    "score": 51
                },
                {
                    "name": "dns_health",
                    "score": 60
                },
                {
                    "name": "endpoint_security",
                    "score": 86
                },
                {
                    "name": "hacker_chatter",
                    "score": 100
                },
                {
                    "name": "ip_reputation",
                    "score": 76
                },
                {
                    "name": "leaked_information",
                    "score": 100
                },
                {
                    "name": "network_security",
                    "score": 67
                },
                {
                    "name": "patching_cadence",
                    "score": 68
                },
                {
                    "name": "social_engineering",
                    "score": 100
                }
            ]
        }
    ]
}