Main Site HUB Security Scorecard API 3.1 Track Scorecard Changes using the Event Log

HUB

3.1 Track Scorecard Changes using the Event Log

Track Changes on a Scorecard using Scorecard Event Log

SecurityScorecard allows you to track changes on a companies scorecard via an API's. This API endpoint allows you to track changes in a companies scorecard over time via API. You can check out the full specification for this endpoint here



SecurityScorecard You can monitor for the following types of changes:

  • Active: new issues have been observed
  • Resolved: issues were refuted and resolution confirmed by SecurityScorecard
  • Departed: issues are not observed anymore
  • Resource URI

    /companies/{domain}/history/events?date_from={from}&date_to={to}

    Parameters:

    Name Required Description
    Domain Y The primary domain identifying a company in SecurityScorecard.
    Date From Y The historical start date (2019-08-01T00:00:00.00Z)
    Date To Y The historical end date (2019-08-05T00:00:00.00Z)

    Sample Code:

    
                curl -X GET \
                    https://api.securityscorecard.io/companies/securityscorecard.com/history/events?date_from=2019-09-13T00:00:00.00Z&date_to=2019-09-17T00:00:00.00Z \
                    -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-17T00:00:00.000Z",
                "detail_url": "https://api.securityscorecard.io/companies/securityscorecard.com/history/events/2019-09-17/issues/tls_ocsp_stapling?group_status=departed",
                "event_type": "issues",
                "factor": "network_security",
                "group_status": "departed",
                "id": 351434,
                "issue_count": 1,
                "issue_type": "tls_ocsp_stapling",
                "severity": "positive",
                "total_score_impact": 0
            },
            {
                "date": "2019-09-16T00:00:00.000Z",
                "detail_url": "https://api.securityscorecard.io/companies/securityscorecard.com/history/events/2019-09-16/issues/tls_ocsp_stapling?group_status=active",
                "event_type": "issues",
                "factor": "network_security",
                "group_status": "active",
                "id": 350827,
                "issue_count": 1,
                "issue_type": "tls_ocsp_stapling",
                "severity": "positive",
                "total_score_impact": 0
            },
            {
                "date": "2019-09-15T00:00:00.000Z",
                "detail_url": "https://api.securityscorecard.io/companies/securityscorecard.com/history/events/2019-09-15/issues/tls_ocsp_stapling?group_status=active",
                "event_type": "issues",
                "factor": "network_security",
                "group_status": "active",
                "id": 170432,
                "issue_count": 2,
                "issue_type": "tls_ocsp_stapling",
                "severity": "positive",
                "total_score_impact": 0
            }
        ]
    }