Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Service Providers in a Folder

Avatar
Ingrid
Follow
  • October 9, 2019: Added parameters; Expanded upon available response fields and their descriptions.

⇤ Folders

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

Get all service providers that companies in a specific folder depend on.

Parameters

*Required.

See query parameters for details on the following parameters:

  • fields
  • format
  • 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.

Example Request

curl https://api.bitsighttech.com/ratings/v1/folders/fcc8b8c4-4fa3-4735-ac14-405ac7855d70/providers -u api_token:

Example Response

{
  "count":79,
  "results":[
    […]
    {
      "provider_guid":"55555555-pppp-rrrr-oooo-dddddddddddd",
      "provider_name":"Black Hills Technologies",
      "provider_industry":"Technology",
      "product_types":[
        "Order Management"
      ],
      "company_count":4,
      "product_count":1,
      "domain_count":5,
      "relative_importance":1.3315300783372361E-5,
      "percent_dependent":0.1,
      "percent_dependent_company":0.1,
      "relative_criticality":"low"
    }
  ]
}

Response Attributes

Field Description 
count
Integer 		The number of service providers in the folder. 
results
Array 		Service provider information of the folder.
  
provider_guid
String [entity_guid]		 The unique identifier of this service provider. 
provider_name
String 		The name of this service provider. 
provider_industry
String 		The industry of this service provider. 
product_types
Array 		The category of services provided by this product. See product types. 
company_count
Integer 		The number of companies within this folder that use this service provider. 
product_count
Integer 		The number of service provider products within this folder that are used by companies. 
domain_count
Integer 		The number of unique domains within this folder that use this service provider. 
relative_importance
String 		A measurement of this product’s importance. See product importance. 
percent_dependent
Decimal 		The percentage of assets (domains) in this folder that depends on this service provider. 
percent_dependent_company
Decimal 		The percentage of companies in this folder that depend on this service provider. 
relative_criticality
String 		The relative criticality of this service provider. See product importance.

Related articles