GET: Product Usage of Companies in a Folder – Bitsight Knowledge Base

https://api.bitsighttech.com/ratings/v1/folders/folder_guid/products/product_guid/companies

List the third parties in a folder that use a particular product type.

Parameters

* Required.

See query parameters for details on the following parameters:

fields
limit
offset
q
sort

Parameter Values

folder_guid

* [Path] Identify the folder to query.

[String] Folder unique identifier [folder_guid]. See GET: Folder Details.

product_guid

* [Path] Identify a service provider product to query.

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

Example Request

curl https://api.bitsighttech.com/ratings/v1/folders/4ce9df6d-e92b-4a5c-9530-521dae4a5f83/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 folder that use the product.
results Array		Product usage details of the companies in the folder.
	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.

Parameters

Example Request

Example Response

Response Attributes

Related articles