---
title: "Retrieves paginated list of supply chain companies."
method: GET
path: "/api/v2/supplychain/companies"
tags: ["SupplyChain"]
---

# Retrieves paginated list of supply chain companies.

`GET /api/v2/supplychain/companies`

Retrieves paginated list of companies from a supply chain search. PivotDomain is optional; when omitted, the customer's corporate domain or the related company of the tenant's domain is used. Only a domain belonging to an actively monitored company can be used as the pivot.

## Query parameters

- `PivotDomain` string — The pivot company domain to analyze supply chain relationships from.
- `SearchToken` string — A key in GUID format, which points to the newly created supply chain search action.
- `page_number` integer
- `page_size` 10 | 20 | 30 | 50 | 100 | 250

## Response `200`

Success

- SupplyChainCompany[]
  - `CompanyId` integer, nullable — Unique identifier of the company. Null if the company is not monitored.
  - `CompanyName` string, nullable — Name of the company.
  - `Domain` string — Primary domain of the company.
  - `LogoUrl` string, nullable — URL to the company logo.
  - `CountryCode` string, nullable — Country code (ISO 3166-1 alpha-2).
  - `CountryName` string, nullable — Country name.
  - `Industry` string, nullable — Industry/sector of the company.
  - `Relationship` 'Unmonitored 3rd Party' | '3rd Party' | '4th Party' — Relationship type with the pivot company.
  - `ComplianceRating` number, double, nullable — Compliance rating percentage of the company (0-100). Only available for monitored companies.
  - `DetectionTypes` string[], nullable — List of detection types.
  - `CyberGrade` object, nullable — Cyber security grade information.
    - `GradeLetter` 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F' — The grade letter code.
    - `CyberRating` number, double — Numeric cyber rating score.
  - `Rsi` number, double, nullable — Ransomware Susceptibility Index (0-1).
  - `Dbi` number, double, nullable — Data Breach Index (0-1).
  - `ConcentrationRisk` object, nullable — Concentration risk information.
    - `Count` integer — Number of monitored companies using this vendor.
    - `Percentage` number, double — Percentage of monitored companies using this vendor.
    - `RiskLevel` 'Low' | 'Medium' | 'High' — Risk level (Low, Medium, High).
  - `IsMonitored` boolean — Indicates whether the company is currently monitored.
  - `Tags` object[], nullable — List of tags associated with the company.
    - `TagId` integer — Tag identifier.
    - `TagName` string — Tag name.
    - `Color` string, nullable — Tag color (hex code).

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/revisions/616dfa9b3b1f/schema)