GET: Service Providers in a Folder

Ingrid

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

folder_guid

* Required.

[Path] Identify the folder to query.

Value: [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	This product’s business function.
	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.

October 9, 2019: Added parameters; Expanded upon available response fields and their descriptions.
March 11, 2019: Published.