POST/v1/supply-chain-risk

Supply Chain Risk API

Evaluate a supplier or vendor domain during pre-check, onboarding, procurement and ongoing third-party risk workflows.

Common use cases

Supplier onboardingVendor due diligenceProcurement pre-checksThird-party risk reviews

Single request

Check one domain

Send a JSON object containing domain.

cURL

curl -X POST https://api.threatprevent.io/v1/supply-chain-risk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"domain":"example.com"}'

Example response

200 OK

{
  "endpoint": "supply-chain-risk",
  "risk": "low",
  "risk_score": 20,
  "source_type": "supply-chain_scan",
  "target": "hashed-or-normalised-target",
  "charged": true,
  "is_free": false,
  "unit_price_pence": 25,
  "billable_units": 1,
  "total_price_pence": 25,
  "charged_from_credit_pence": 25,
  "overage_pence": 0,
  "remaining_credit_pence": 2475
}

Try it

Interactive API explorer

API keyJSON request

Response

Response will appear here.

The API key stays in this browser component state and is sent directly to the ThreatPrevent API.

POST/v1/supply-chain-risk/bulk

Bulk Supply Chain Risk

Submit up to 10,000 domains in one HTTP request. Billing is calculated by records processed.

cURL

curl -X POST https://api.threatprevent.io/v1/supply-chain-risk/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"domains":["example.com","supplier.example","vendor.example"]}'

Illustrative bulk response

{
  "results": [
    {
      "domain": "example.com",
      "risk": "low"
    },
    {
      "domain": "supplier.example",
      "risk": "medium"
    },
    {
      "domain": "vendor.example",
      "risk": "low"
    }
  ],
  "charged": true,
  "is_free": false,
  "unit_price_pence": 25,
  "billable_units": 3,
  "total_price_pence": 75,
  "charged_from_credit_pence": 75,
  "overage_pence": 0
}

Try it

Interactive API explorer

API keyJSON request

Response

Response will appear here.

The API key stays in this browser component state and is sent directly to the ThreatPrevent API.

Risk interpretation

Low

No significant risk signal identified from the intelligence currently available.

Medium

A risk signal warrants additional review before making the decision.

High

Significant risk indicators are present and the decision should be escalated.

High

Escalate the supplier for additional due diligence.

Medium

Review the supplier before onboarding or transacting.

Low

Proceed according to your normal supplier controls.

Decision-support notice

Threat intelligence is time-sensitive and cannot provide visibility of every threat. Risk results should be used as an additional decision signal rather than as the sole control for critical business decisions.