GET: Service Provider Products in a Tier – Bitsight Knowledge Base

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 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] Filter results by 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	This product’s business function.
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

October 10, 2019: Published.

Parameters

Example Request

Example Response

Response Attributes

Related articles