Skip to main content
Security Performance Management
Continuous Monitoring
Vendor Risk Management
Trust Management Hub
Cyber Insurance
National Cybersecurity

GET: Insights

Ingrid

⇤ Endpoints

https://api.bitsighttech.com/ratings/v1/insights

Retrieve the significant rating change data of a requested company. The information includes the initial and final rating of a company over a certain range of time, the reason behind the rating change, and the percentile change of the company’s rating.

Parameters

See query parameters for details on the format (value: json) parameter.

* Required.

Parameter Values 
company

* [Query] Identify the company to query.

 [String] Company unique identifier [entity_guid]. GET: Portfolio Details./td 
start

[Query] Select the date for when to begin looking for insights.

 [String] YYYY-MM-DD 
end

[Query] Select the date for when to stop looking for insights.

 [String] YYYY-MM-DD 
score_delta_lt

[Query] Filter by rating change explanations (RCE), as highlighted in the Security Ratings Timeline so that the delta is lower than the specified value.

[String]

  • 0 = Include rating changes of 10 points or less.
  • If not specified, the results are filtered by a delta lower than -10 points.

Example Request

curl https://api.bitsighttech.com/ratings/v1/insights?company=company_guid -u api_token:

Example Response

[
  {
    "date":"2018-10-09",
    "guid":"88deb5fa-d371-4707-b9fb-ffc1878cc28a",
    "start_score":790,
    "end_score":770,
    "reasons":[
      {
        "start_percentile":47.59024,
        "risk_vector":"insecure_sys",
          "evidence":[
            {
              "end_grade":"D",
              "start_grade":"C"
            }
          ],
        "end_percentile":31.86136,
      }
    ],
    "type":"rating-change",
    "entity":"a940bb61-33c4-42c9-9231-c8194c305db3"
  }
]

Response Attributes

Field Description 
date
String [YYYY‑MM‑DD]		 The date when this organization's security rating changed. 
guid
String [insight_guid]		 The unique identifier of the insight. 
start_score
Integer		 This organization’s security rating at the beginning of the day. 
end_score
Integer		 This organization’s security rating at the end of the day. 
reasons
Object		 The data points that contributed to the change in this organization’s security rating.
  
start_percentile
Decimal		 The percentile that this organization was placed in, at the beginning of the day. This is based on its rating within the industry. 
risk_vector
String		 The slug name of the risk vector type that contributed to the reason for the change. 
evidence
Object		 The letter grade of the risk vector that contributed to the reason for the change, before and after the change.
  
end_grade
String		 The letter grade of the risk vector that contributed to the reason for the change, after the change. 
start_grade
String		 The letter grade of the risk vector that contributed to the reason for the change, before the change. 
end_percentile
Decimal		 The percentile that this organization was placed in at the end of the day. This is based on its rating within the industry. 
type
String

The type of reason for the rating change.

Value: rating-change
 
entity
String [entity_guid]		 The unique identifier of this company.
  • July 10, 2023: Removed PDF.
  • April 18, 2019: Published.

Related articles

Feedback

0 comments

Please sign in to leave a comment.