GET: Product Usage of Companies in a Ratings Tree

Ingrid

https://api.bitsighttech.com/ratings/v1/companies/company_guid/company-tree/products/product_guid/companies

List the third parties in a ratings tree that use products that have a particular business function.

Parameters

* Required.

See query parameters for details on the following parameters:

fields
limit
offset
q
sort

company_guid

* Required.

[Path] Identify the company to query.

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

product_guid

* Required.

[Path] Identify a service provider product to query.

Value: [String] Product unique identifier [product_guid]. See GET: Products of a Company.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/company-tree/products/prod1234-prod-1234-prod-1234prod1234/companies -u api_token:

Example Response

{
  "count":2,
  "results":[
    […]
    {
      "company_guid":"19d16bf5-11a6-467b-b7b1-f5563daece69",
      "company_name":"Pollinate, Inc.",
      "domain_count":2,
      "percent_dependent":15.4,
      "relationship_source":"bitsight"
    }
  ]
 }

Response Attributes

Field		Description
count Integer		The number of companies in this Ratings Tree that use the product.
results Array		Product usage details of the companies in the Ratings Tree.
	company_guid String [`entity_guid`]	The unique identifier of this company.
	company_name String	The name of this company.
	domain_count Integer	The number of unique domains of this company that use the product.
	percent_dependent Decimal	The percentage of assets (domains) of this company that use the product.
	relationship_source String	How the relationship between this company and the service provider was curated. See fourth party relationships.

October 19, 2020: Published.