Tiers API Endpoint

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

Tiers can be used as filters to drive alerts on security ratings or risk vector grades, just like the folder functionality. Operationalize and prioritize company management, based on third party criticality to your organization and their security risk.

Paths

GET: Tiers

Get a list of your tiers.

Path: GET /v1/tiers

GET: Tier Summaries

Get summaries of your tiers.

Path: GET /v1/tiers/summary

PATCH: Edit Tiers

Create or edit an existing tier. Assign a name and description.

Path: PATCH /v1/tiers/tier_guid

PATCH: Modify Companies in a Tier

Add companies to an existing tier or remove companies from an existing tier.

Path: PATCH /v1/tiers/tier_guid/companies

GET: Product Usage of Companies in a Tier

List the third parties in a tier that use a particular service provider product.

Path: GET /v1/tiers/tier_guid/products/product_guid/companies

GET: Product Types in a Tier

List the product types used by third parties in a tier.

Path: GET /v1/tiers/tier_guid/product-types

GET: Service Providers in a Tier

Get all service providers within a tier.

Path: GET /v1/tiers/tier_guid/providers

GET: Tiered Companies Dependent on a Specific Service Provider

Get companies within one of your tiers that depends on a specific service provider.

Path: GET /v1/tiers/tier_guid/providers/company_guid/companies

GET: Service Provider Products in a Tier

Get the service provider products within a tier.

Path: GET /v1/tiers/tier_guid/providers/company_guid/products

GET: Tiered Company GUID by Action Plan

Get the unique identifiers of tiered companies [entity_guid] that are within each distinct vendor action plan (monitor, review, escalate).

Path: GET /v1/tiers/vendor-action-plan