---
title: "Searches through supply chain relationships."
method: POST
path: "/api/v2/supplychain/search"
tags: ["SupplyChain"]
---

# Searches through supply chain relationships.

`POST /api/v2/supplychain/search`

Create a search operation for supply chain analysis. This endpoint will not return the list of resulting companies, but instead it will return a search token that can be used to list the supply chain companies found by using getSupplyChainCompanies operation. 
 **Attention:** Every unique client id can create a maximum of 100000 search keys per day.

## Request body

- object
  - `Relationships` string[], nullable — The list of relationship types to filter companies by.
  - `CountryCodes` string[], nullable — The list of countries that the companies belong to in two letters format.
  - `IndustryIds` integer[], nullable — The list of industry ids that the companies are classified with.
  - `TagIds` integer[], nullable — The list of tag ids that the companies are attributed with.
  - `EcosystemIds` integer[], nullable — The list of ecosystem ids that the companies are defined under.
  - `GradeLetters` string[], nullable — The list of grade letters that the companies have as a technical risk score.
  - `DetectionTypes` string[], nullable — The list of detection types to filter companies by.
  - `AssetCountryCodes` string[], nullable — The list of countries that the assets belong to in two letters format.
  - `RsiMin` number, double, nullable — The value of minimum Ransomware Susceptibility Index (0-1).
  - `DbiMin` number, double, nullable — The value of minimum Data Breach Index (0-1).
  - `FairMin` number, double, nullable — The value of minimum FAIR score.
  - `ConcentrationRiskMin` integer, nullable — The minimum concentration risk percentage to filter companies by (1-100).
  - `ComplianceRatingMax` integer, nullable — The maximum compliance rating percentage to filter companies by (0-100).

## Response `200`

Success

- object
  - `Key` string, required — A key in GUID format, which points to the newly created supply chain search action. Use this key in getSupplyChainCompanies action as a URL parameter in order to fetch the results. The key has a lifetime of 6 hours. A new search operation should be performed when the search keys are expired.

## Other responses

- `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/7dadaba760fb/schema)