GET: Grades by Country-Industry

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

Get risk vector grades from a particular country-industry.

• Parameters
• Example Request
• Example Response
• Response Attributes

Parameters

* Required.

country_guid

* Required.

[Path] Identify the country to query.

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

industry_guid

* Required.

[Path] Identify the country-industry to query.

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

period

[Query] Set a time period.

Value: [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

guid

name

rating_date

grades

risk_vector

name

slug

risk_category

grade

percentile

Response Codes

See common errors and status codes.

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.