Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Product Usage of Companies in a Folder

Avatar
Ingrid
Follow
Publication Date – October 19, 2020

⇤ Folders

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

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

Parameters

*Required.

See query parameters for details on the following parameters:

  • fields
  • limit
  • offset
  • q
  • sort
Parameter Description 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/folder_guid/products/product_guid/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.

Related articles