GET: Product Usage of Companies in a Tier

Ingrid

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

See third parties in a tier that use a product with a particular business function.

Parameters

* Required.

See query parameters for details on the following parameters:

fields
limit
offset
q
sort

tier_guid

* Required.

[Path] Identify the tier to query.

Value: [String] Tier unique identifier [tier_guid]. See GET: Tiers.

product_guid

* Required.

[Path] Identify a service provider product to query.

Value: [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.