Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET, POST: Security Rating Details of Countries in Your Portfolio

Avatar
Ingrid
Follow
  • July 30, 2020: Error 413.

⇤ Portfolio for National Cybersecurity

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

Get security rating details of the countries in your portfolio, including the unique identifiers of particular countries.

Parameters

Parameter Description Values 
expand
Query		 Show the letter grades of each risk vector.

This parameter might result in a large amount of data. See error 413 for details.

 [String] rating_details 
period
Query		 Specify a time interval to filter the ratings data. [String]
  • daily
  • monthly
  • latest
Example: ?period=monthly
 
start_date
Query		 Filter the ratings data by starting date. [String] YYYY-MM-DD 
end_date
Query		 Filter the ratings data by the end date. [String] YYYY-MM-DD

Example GET Request

Use a GET request to retrieve data for your entire portfolio.

curl -X GET 'https://api.bitsighttech.com/ratings/v1/portfolio/ratings?expand=rating_details&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&period=time_interval' -u api_token:

Example POST Request

Use a POST to customize the JSON body for the request, i.e. select a subset of countries instead of your entire portfolio.

curl -X POST https://api_token@service.bitsighttech.com/ratings/v1/portfolio/ratings -d '{"companies":["country_a_guid","country_b_guid"],"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD","expand":"rating_details","period":"time_interval'

Example Response

[
  {
    "ratings":[
      {
        "date":"2019-10-19",
        "rating":600,
        "percentile":20
      }
    ],
    "guid":"5d04c480-b1e7-48af-9633-82996a8446fc",
    "name":"Demo Country 1"
  }
]

Response Attributes

The following table describes the attributes of a country’s rating details object.

Field Description 
ratings
Array		 A list of objects containing security rating details of a country. 
date
String [YYYY‑MM‑DD]		 The date when this rating details object was retrieved. 
rating
Integer		 The headline security rating of this country on the specified date. 
percentile
Integer		   
guid
String [entity_guid]		 The unique identifier of this country. 
name
String		 The name of this country.

Status Codes

See the standard response codes.

Code Description
413 The amount of data being computed is too high. We recommend making the response smaller either by setting the period parameter value to latest (?period=latest) or by not including the expand parameter.

Related articles