POST: Use Current Ratings License

https://api.bitsighttech.com/ratings/v1/current-ratings

Use a Current Ratings license for getting a 24-hrs snapshot of a company’s rating.

Vendor Risk Assessment Data Service (VRADS)

Parameters

* Required.

guids

* Required.

[Data] Identify the company to query.

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

use_license

* Required.

[Data] Use a Current Ratings license to get a snapshot of this company’s rating.

Value: [Boolean] true = Use license.

Example Request

curl -H "Content-Type: application/json" -X POST -i https://api.bitsighttech.com/ratings/v1/current-ratings -u api_token: -d '{
"guids": ["9ecd7b7e-42b4-4d32-99e8-1b65e59b0774"],
"use_license": true}'

Example Response

{
  "results":[
    {
      "guid":"9ecd7b7e-42b4-4d32-99e8-1b65e59b0774",
      "name":"Frontstore, Inc.",
      "rating":690,
      "rating_category":"intermediate"
    }
  ],
  "rating_as_of":"2023-10-04",
  "rating_licenses_used":0,
  "total_rating_licenses_used":0,
  "total_rating_licenses_remaining":0
}

Response Attributes

results

guid

name

rating

rating_category

rating_as_of

rating_licenses_used

total_rating_licenses_used

total_rating_licenses_remaining

Response Codes

200 – Okay

Everything worked as expected.

400 – Bad Data

The request was incorrect. This can often be due to missing a required parameter.

401 – Unauthorized

No valid API token was provided.

403 – Permission Denied

You do not have permission to access this resource.

404 – Not Found

The specified resource could not be found.

default

Unexpected error.