- October 19, 2020: Added GET: Product Usage of Companies in a Tier (
/v1/tiers/{tier_guid}/products/{product_guid}/companies). - October 13, 2020: Added GET: Product Types in a Tier (
/v1/tiers/{tier_guid}/product-types).
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
| Path | Purpose | Description |
|---|---|---|
/v1/tiers |
GET: Tiers | Get a list of your tiers. |
/v1/tiers/summary |
GET: Tier Summaries | Get summaries of your tiers. |
/v1/tiers/tier_guid
|
PATCH: Edit Tiers | Create or edit an existing tier. Assign a name and description. |
/v1/tiers/tier_guid/companies
|
PATCH: Modify Companies in a Tier | Add companies to an existing tier or remove companies from an existing tier. |
/v1/tiers/tier_guid/products/product_guid/companies |
GET: Product Usage of Companies in a Tier | List the third parties in a tier that use a particular service provider product. |
/v1/tiers/tier_guid/product-types
|
GET: Product Types in a Tier | List the product types used by third parties in a tier. |
/v1/tiers/tier_guid/providers
|
GET: Service Providers in a Tier | Get all service providers within a tier. |
/v1/tiers/tier_guid/providers/company_guid/companies |
GET: Tiered Companies Dependent on a Specific Service Provider | Get companies within one of your tiers that depends on a specific service provider. |
/v1/tiers/tier_guid/providers/company_guid/products |
GET: Service Provider Products in a Tier | Get the service provider products within a tier. |
/v1/tiers/vendor-action-plan |
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). |