---
title: "Inbound Supply Chain Risks"
method: POST
path: "/search-by-domain/supply-chain-risks"
tags: ["Domain Intelligence"]
---

# Inbound Supply Chain Risks

`POST /search-by-domain/supply-chain-risks`

Returns the paginated inbound Supply Chain Risks view for a single domain: ranked third-party partner cards discovered from compromised credentials, enriched with company information. Requires the `supply_chain_monitoring` api permission.

## Request body

- object
  - `domain` string, required — The subject domain to scan for inbound supply chain risks.
  - `page` integer — Page number (1-based).
  - `limit` integer — Number of partner cards per page.
  - `sort_by` 'size' | 'occurrence' | 'name' — Sort order. `size` = company size DESC (default), `occurrence` = most compromised, `name` = A to Z.

## Response `200`

Successful inbound supply chain scan

- object
  - `success` boolean
  - `domain` string
  - `total` integer
  - `page` integer
  - `limit` integer
  - `data` object[]
    - `domain` string
    - `source_domain` string
    - `partner_occurrence` integer
    - `name` string
    - `size` string
    - `industry` string
    - `location_locality` string
    - `location_region` string
    - `location_country` string
    - `compromised_counts` object
    - `last_employee_compromised` string, date-time
    - `last_employee_uploaded` string, date-time
    - `last_user_compromised` string, date-time
    - `last_user_uploaded` string, date-time
    - `passwords_strength` object
    - `applications_found` object
    - `antiviruses_stats` object

## Other responses

- `400` — Validation error - the request or request body was invalid
- `401` — Unauthorized - the server could not authenticate the request
- `403` — Forbidden - the server authenticated the request but refuses to process it because of insufficient permissions
- `408` — Timeout - the server timed out while waiting for a response (90 seconds)
- `429` — Rate limit exceeded - the server has received too many requests in a short period of time
- `500` — Internal server error - the server encountered an unexpected condition that prevented it from fulfilling the request

---

[API](https://skmtc.net/hudsonrock/apis/cavalier-api.md) · [All operations](https://skmtc.net/hudsonrock/apis/cavalier-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hudsonrock/cavalier-api/versions/5ba0142eec4d/schema)