GET: Service Providers in a Tier – Bitsight Knowledge Base

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

Get all service providers 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.

Example Request

curl https://api.bitsighttech.com/ratings/v1/tiers/e325bd1d-b5ee-4fa5-a1ee-8e87518b0746/providers -u api_token:

Example Response

{
  [
    […]
    {
      "provider_guid":"a5e23bf0-38d4-4cea-aa50-19ee75da481d",
      "provider_name":"Black Hills Technologies",
      "provider_industry":"Technology",
      "product_types":[ 
        "Order Management"
      ],
      "company_count":1,
      "product_count":1,
      "domain_count":1,
      "relative_importance":0.0067566781346803375,
      "percent_dependent":0.1,
      "percent_dependent_company":1.1,
      "relative_criticality":"low"
    }
  ]
}

Response Attributes

Field	Description
provider_guid String [`entity_guid`]	The unique identifier of this service provider.
provider_name String	The name of this service provider.
provider_industry String	The industry this service provider belongs to. See the list of industries.
product_types Array	This product’s business function. See the list of product types.
company_count Integer	The number of companies in this tier that depend on this service provider.
product_count Integer	The number of products used by companies in this tier.
domain_count Integer	The number of unique domains within this tier that have 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
percent_dependent Decimal	The percentage of assets (domains) in this tier that depends on this service provider.
percent_dependent_company Decimal	The percentage of companies in this tier that depend on the service provider.
relative_criticality String	Reiterates the `relative_importance` field. Values: `low` `medium` `high` `critical`

October 10, 2019: Published.

Parameters

Example Request

Example Response

Response Attributes

Related articles