Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

GET: Security Ratings History of an Industry

Avatar
Ingrid
Follow
Publication Date – January 20, 2020

⇤ Industries

https://api.bitsighttech.com/ratings/v1/industries/industry_slug

Get a 1-year security ratings history of a particular industry.

Example Request

Visiting the industry URI found in the Industries overview endpoint.

curl https://api.bitsighttech.com/ratings/v1/industries/technology -u api_token:

Example Response

The server returns an array of objects containing individual rating_date and rating subkeys, ordered by most recent to least recent.

{
  "ratings": [
    […]
    {
      "rating": 620,
      "rating_date": "2014-12-21"
    }
  ],
  "name": "Technology",
  "company_distribution": [
    […]
    {
      "max": 900,
      "percent": 66.65,
      "min": 700
    }
  ],
  "name": "Technology"
}

Response Attributes

Field Description 
ratings
Array		  
  
rating_date
String [YYYY‑MM‑DD]		 The date when this rating was issued. 
rating
Integer		 The average security rating for the industry on this day, as measured by the Bitsight Security Rating Platform. 
name
String		 The name of the industry. 
company_distribution
Array		 The distribution of companies in the Bitsight inventory from that industry.
  
name
String		 The name of the industry. 
max
Integer		 The maximum rating for the category. 
percent
Decimal		 The percent of the total number of companies (including companies that are independent from your portfolio) and are in each of the designated rating categories (basic, intermediate, advanced) for that industry. 
min
Integer		 The minimum rating for the category.

Related articles