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

Ingrid

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

folder_guid

* Required.

[Path] Identify the folder to query.

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

provider_guid

* Required.

[Path] Identify the service provider to query.

Value: [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.

October 15, 2019: Published.