Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Dependency on a Specific Service Provider in a Ratings Tree

Avatar
Ingrid
Follow
Publication Date – October 15, 2019

⇤ Companies

https://api.bitsighttech.com/ratings/v1/companies/company_guid/company-tree/providers/provider_guid/companies

Get the companies in a Ratings Tree that depend on a specific service provider.

Parameters

*Required.

See query parameters for details on the following parameters:

  • fields
  • limit
  • offset
  • q
  • sort
Parameter Description Values 
company_guid
Path		 Identify the company to query. [String] Company unique identifier [entity_guid]. See GET: Portfolio Details. 
provider_guid
Path		 Identify the service provider to query. [String] Service provider unique identifier [entity_guid]. See GET: Service Providers for a Specific Domain.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/company-tree/providers/a5e23bf0-38d4-4cea-aa50-19ee75da481d/companies -u api_token:

Example Return

{
  [
    {
      "company_guid":"a940bb61-33c4-42c9-9231-c8194c305db3",
      "company_name":"Saperix, Inc.",
      "domain_count":3,
      "percent_dependent":18.8,
      "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 among the companies in this Ratings Tree that depend on the service provider. 
percent_dependent
Decimal		   
relationship_source
String		 How the relationship between this company and the service provider was curated.