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

GET: Grades by Country-Industry

Ingrid

https://api.bitsighttech.com/ratings/v1/territories/country_guid/industries/industry_guid/grades/

Get risk vector grades from a particular country-industry.

Available for National Cybersecurity.

Parameters

* Required.

Parameter Values 
country_guid

* [Path] Identify the country to query.

 [String] Country unique identifier [entity_guid]. See GET: Portfolio Details. 
industry_guid

* [Path] Identify the country-industry to query.

 [String] Industry unique identifier [industry_guid]. See GET: Ratings of Industries Within a Country. 
period

[Query] Set a time period.

[String]

  • latest (default) = Today’s grades.
  • monthly = Grades on the first day of each month during the last 12 months.

Example Request

curl https://api.bitsighttech.com/ratings/v1/territories/5d04c480-b1e7-48af-9633-82996a8446fc/industries/08da2e31-2b5b-4457-9fe5-c740904282b3/grades/ -u api_token:

Example Response

{
  "guid":"5d04c480-b1e7-48af-9633-82996a8446fc",
  "name":"Demo Country 1 - Technology",
  "rating_date":"2021-09-01",
  "grades":[
    {
      "risk_vector":{
        "name":"Botnet Infections",
        "slug":"botnet",
        "risk_category":"Compromised Systems"
      },
      "grade":"A",
      "percentile":100.0
    }
  ]
}

Response Attributes

Field Description 
guid
String [entity_guid]		 The unique identifier of the country. 
name
String		 The name of the country and industry. 
rating_date
String [YYYY-MM-DD]		 The date when the grades were calculated. 
grades
Array		 Grades grouped by risk vector.
  
risk_vector
Object		 Risk vector information.
  
name
String		 The name of this risk vector. 
slug
String		 The slug name of this risk vector. 
risk_category
String		 The category of this risk vector. 
grade
String		 The letter grade of this risk vector. 
percentile
Decimal		 The percentile this country is placed in, based on its rating within the industry.

Response Codes

See common errors and status codes.

Code Description
200 – Okay Everything worked as expected.
401 – Unauthorized
  • You are not subscribed to the country.
  • You are not subscribed to the region.
404 – Not Found The territory or industry was not found.
October 15, 2021: Published.

Related articles

Feedback

0 comments

Please sign in to leave a comment.