GET: Product Usage of Companies in a Tier – Bitsight Knowledge Base

https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/products/product_guid/companies

See third parties in a tier that use a particular product.

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.

product_guid

* [Path] Identify a service provider product to query.

[String] Product unique identifier [product_guid]. See GET: Products of a Company.

Example Request

curl https://api.bitsighttech.com/ratings/v1/tiers/tier1234-tier-1234-tier-1234tier1234/products/prod1234-prod-1234-prod-1234prod1234/companies -u api_token:

Example Response

{
  "count":58,
  "results":[
    […]
    {
      "company_guid":"19d16bf5-11a6-467b-b7b1-f5563daece69",
      "company_name":"Pollinate, Inc.",
      "domain_count":2,
      "percent_dependent":15.4,
      "relationship_source":"bitsight"
    }
  ]
}

Response Attributes

Field		Description
count Integer		The number of companies in this tier that use the product.
results Array		Product usage details of the companies in the tier.
	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 this company’s unique domains that use the product.
	percent_dependent Decimal	The percentage of assets (domains) of this company that use the product.
	relationship_source String	How the relationship between this company and the service provider was curated. See fourth party relationships.

October 19, 2020 Published.

Parameters

Example Request

Example Response

Response Attributes

Related articles