Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Service Provider Products in a Tier

Avatar
Ingrid
Follow
Publication Date – October 10, 2019

⇤ Tiers

https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/providers/provider_guid/products

Get the service provider products within a tier.

Parameters

*Required.

See query parameters for details on the following parameters:

  • fields
  • limit
  • offset
  • q
  • sort
Parameter Description Values 
tier_guid
Path 		Identify the tier to query. [String] Tier unique identifier [tier_guid]. See GET: Tiers. 
provider_guid
Path 		Identify the service provider to query. [String] Company unique identifier [entity_guid]. See GET: Service Providers for a Specific Domain. 
relationship_type
Query 		The type of relationship between this company and its fourth party. [String] Relationship type.

Example Request

curl https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/providers/provider_guid/products -u api_token:

Example Response

{
  [
    […]
    {
      "product_guid":"55555555-pppp-rrrr-oooo-dddddddddddd",
      "product_name":"Black Hills POS",
      "product_types":[
        "Order Management"
      ],
      "provider_guid":"a5e23bf0-38d4-4cea-aa50-19ee75da481d",
      "provider_name":"Black Hills Technologies",
      "provider_industry":"Technology",
      "company_count":1,
      "domain_count":1,
      "percent_dependent":6.3,
      "percent_dependent_company":9.1,
      "relative_importance":0.09375,
      "relative_criticality":"high"
    }
  ]
}

Response Attributes

Field Description 
product_guid
String [product_guid]		 The unique identifier of this product. 
product_name
String 		The name of this product. 
product_types
Array 		The category of services provided by this product. 
provider_guid
String [entity_guid]		 The unique identifier of the service provider for this product. 
provider_name
String 		The name of the service provider for this product. 
provider_industry
String 		The industry of the service provider for this product. 
company_count
Integer 		The number of companies within this tier that depend on this product. 
domain_count
Integer 		The number of domains within this tier that depends on this product. 
percent_dependent
Decimal 		The percentage of assets (domains) in this tier that depends on this product. 
percent_dependent_company
Decimal 		The percentage of companies in this tier that depends on this product. 
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
 
relative_criticality
String 		Reiterates the relative_importance field.
Values:
  • low = 0 ↹ .005 Importance
  • medium = .005 ↹ .075 Importance
  • high = .075 ↹ .5 Importance
  • critical = .5 ↹ 1 Importance