Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Service Providers of a Specific Company

Avatar
Ingrid
Follow
  • March 29, 2022: Added response details – company_count, product_count, domain_count, relative_importance, percent_dependent, & percent_dependent_company.
  • October 9, 2019: Published.

⇤ Companies

https://api.bitsighttech.com/ratings/v1/companies/company_guid/providers

Get the service providers that a specific company depends on.

Parameters

*Required.

See query parameters for details on the following parameters:

  • fields
  • limit (Default: All)
  • offset
  • q
  • sort
Parameter Description Values 
company_guid
Path		 Identify the company to query. [String] Company unique identifier [entity_guid]. See GET: Portfolio Details.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/providers -u api_token:

Example Response

{
  "count":43,
  "results":[
    […]
    {
      "provider_guid":"dddddddd-5555-dddd-5555-dddddddddddd",
      "provider_name":"Example Provider, Inc.",
      "provider_industry":"Technology",
      "product_types":[
        "Network Management",
        "Server Technologies"
      ],
      "company_count":1,
      "product_count":1,
      "domain_count":9,
      "relative_importance":3.125,
      "percent_dependent":56.3,
      "percent_dependent_company":100.0,
      "relative_criticality":"critical",
      "relationship_source":"bitsight"
    }
  ]
}

Response Attributes

Field Description 
count
Integer		 The number of results. 
results
Array		 Service provider details.
  Object A service provider and its details.
  
provider_guid
String [entity_guid]		 This service provider's unique identifier. 
provider_name
String		 This service provider's name. 
provider_industry
String		 This service provider's industry. 
product_types
Array		 The categories of the service provider's product. See the list of product types. 
company_count
Integer		 The number of companies relying on this service provider. 
product_count
Integer		 The number of products provided by this service provider. 
domain_count
Integer		 The number of this service provider's domains. 
relative_importance
Decimal		 A measurement of this product’s importance.
Values:
  • 0 ↹ .005 = Low Criticality
  • .005 ↹ .075 = Medium Criticality
  • .075 ↹ .5 = High Criticality
  • .5 ↹ 1 = Critical Criticality
 
percent_dependent
Decimal		 The percentage of assets (domains) in that depends on this service provider. 
percent_dependent_company
Decimal		 The percentage of companies that depend on this service provider. 
relative_criticality
String		 Reiterates the relative_importance field.
Values:
  • low
  • medium
  • high
  • critical
 
relationship_source
String		 How the relationship between this company and the service provider was curated. See fourth party relationships.

Status Codes

See the common errors and status codes.

Code Description
200 – Okay Everything worked as expected.

Related articles