Assess supplier domains

Assesses up to 50 domains against the source records and uses one supplier assessment from your period quota per request. The documented A–F grade uses infection count, recency, and the critical-system flag.

POST/v1/supply-chain/assess

POSTAssess supplier domains

curl -X POST "https://api.darkradar.com/api/public/v1/supply-chain/assess" \
  -H "x-api-key: $DARKRADAR_API_KEY"

Response

Success

{
  "success": true,
  "data": {
    "items": [
      {
        "domain": "vpn.vendor.example",
        "infections": 12,
        "lastSeenAt": "2026-09-20T10:00:00.000Z",
        "score": 100,
        "grade": "F",
        "ageDays": 0,
        "criticalSystem": true
      }
    ],
    "credits": {
      "remaining": 98,
      "cap": 100
    },
    "rateLimit": {
      "remaining": 18,
      "limit": 20
    }
  }
}

Access

Scopesupply-chain:assess

Plan entitlementapi_access + supply_chain_assess

Responses

200Success

400Invalid request (malformed id, missing or invalid field)

401Key missing, invalid, expired or revoked

402Your supplier assessment quota for this period is used up; no assessment was run

403Insufficient scope, no API access in plan, or product not enabled

404Record not found or not owned by this key’s firm

408The request exceeded its maximum response time

429The per-minute request limit for your firm was exceeded; wait the number of seconds in the `Retry-After` header

Supplier riskResponse model

Response limits

Rate limit500 requests per 15 min · per IP