GET: Service Providers of a Specific Company

Ingrid

https://api.bitsighttech.com/ratings/v1/companies/company_guid/providers

Get the service providers that a specific company depends on.

Parameters

* Required.

See query parameters for details on the following parameters:

fields
limit (Default: ↻ All)
offset
q
sort

company_guid

* Required.

[Path] Identify the company to query.

Value: [String] Company unique identifier [entity_guid]. See GET: Portfolio Details.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/providers -u api_token:

Example Response

{
  "count":43,
  "results":[
    […]
    {
      "provider_guid":"dddddddd-5555-dddd-5555-dddddddddddd",
      "provider_name":"Example Provider, Inc.",
      "provider_industry":"Technology",
      "product_types":[
        "Network Management",
        "Server Technologies"
      ],
      "company_count":1,
      "product_count":1,
      "domain_count":9,
      "relative_importance":3.125,
      "percent_dependent":56.3,
      "percent_dependent_company":100.0,
      "relative_criticality":"critical",
      "relationship_source":"bitsight"
    }
  ]
}

Response Attributes

Field			Description
count Integer			The number of results.
results Array			Service provider details.
	Object		A service provider and its details.
		provider_guid String [`entity_guid`]	This service provider's unique identifier.
		provider_name String	This service provider's name.
		provider_industry String	This service provider's industry.
		product_types Array	This product’s business function.
		company_count Integer	The number of companies relying on this service provider.
		product_count Integer	The number of products provided by this service provider.
		domain_count Integer	The number of this service provider's domains.
		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 that depends on this service provider.
		percent_dependent_company Decimal	The percentage of companies that depend on this service provider.
		relative_criticality String	Reiterates the `relative_importance` field. Values: `low` `medium` `high` `critical`
		relationship_source String	How the relationship between this company and the service provider was curated. See fourth party relationships.

Status Codes

See the common errors and status codes.

200 – Okay: Everything worked as expected.

March 29, 2022: Added response details – company_count, product_count, domain_count, relative_importance, percent_dependent, & percent_dependent_company.
October 9, 2019: Published.