Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Companies in a Folder that Depends on a Specific Service Provider

Avatar
Ingrid
Follow
Publication Date – October 15, 2019

⇤ Folders

https://api.bitsighttech.com/ratings/v1/folders/folder_guid/providers/provider_guid/companies

Get all companies within a folder that depends on a specific service provider.

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. 
provider_guid
Path 		Identify the service provider to query. [String] Company unique identifier [entity_guid]. See GET: Service Providers for a Specific Domain.

Example Request

curl https://api.bitsighttech.com/ratings/v1/folders/fcc8b8c4-4fa3-4735-ac14-405ac7855d70/providers/a5e23bf0-38d4-4cea-aa50-19ee75da481d/companies -u api_token:

Example Response

{
  [
    […]
    {
      "company_guid":"aaaaaaaa-4444-4444-aaaa-444444444444",
      "company_name":"Example Company",
      "domain_count":2,
      "percent_dependent":40.0,
      "relationship_source":"bitsight"
    }
  ]
}

Response Attributes

Field Description 
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 domains in this folder. 
percent_dependent
Decimal 		The percentage of assets (domains) in this folder that depends on this service provider. 
relationship_source
String 		How the relationship between this company and the service provider was curated.