API documentation

Assess supplier risk

Review the third-party surface of employee accounts and grade new supplier domains from A to F.

Fetch inbound risks

curl -G "https://api.darkradar.com/api/public/v1/supply-chain/inbound" \
  -H "x-api-key: $DARKRADAR_API_KEY"
{
  "success": true,
  "data": {
    "items": [
      {
        "domain": "vpn.vendor.example",
        "affectedEmployees": 2,
        "infections": 2,
        "lastSeenAt": "2026-09-20T10:00:00.000Z",
        "severity": "critical",
        "score": 70,
        "grade": "E",
        "ageDays": 0,
        "criticalSystem": true
      }
    ]
  }
}

Assess suppliers in bulk

Send up to 50 domains in one request. Each request uses one supplier assessment from your period quota; the score combines distinct infections, recency, and a VPN/SSO/identity-system flag.

curl -X POST "https://api.darkradar.com/api/public/v1/supply-chain/assess" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "content-type: application/json" \
  --data '{"domains":["vpn.vendor.example","portal.supplier.example"]}'

Was this page helpful?