SupplyShield Risk Intelligence API

Enterprise-grade supply chain disruption risk scoring engine. Get deterministic, explainable risk assessments for supply chain entities based on geopolitical, logistics, concentration, transit, and regulatory factors.

🎯 Key Features

Instant Risk Scoring – Get comprehensive risk scores (0-100) with tier classifications (Low, Medium, High, Critical)
Multi-Dimensional Analysis – Evaluates geopolitical, logistics, concentration, transit, and regulatory risk factors
Full Explainability – Every score includes primary drivers, contributing factors, and actionable recommendations
Bulk Processing – Analyze up to 100 entities in a single API call
Zero Configuration – No API keys to manage, authentication handled by RapidAPI

📊 Risk Dimensions

Dimension	Description
Geopolitical	Country stability, sanctions exposure, political risk
Logistics	Transport mode reliability, regional infrastructure
Concentration	Supplier count, tier depth, single-source dependency
Transit	Chokepoint exposure (Suez, Panama, Malacca, etc.)
Regulatory	Export controls, trade restrictions, compliance flags

🚀 Quick Start

Single Risk Assessment

POST /risk-score
Content-Type: application/json

{
  "supplier_country": "TW",
  "facility_region": "east_asia",
  "transport_modes": ["sea", "air"],
  "chokepoints": ["malacca"],
  "supplier_count": 1,
  "tier_depth": 2,
  "time_sensitivity": "just_in_time",
  "has_historical_disruptions": true,
  "regulatory_flags": ["export_control", "strategic_technology"],
  "geopolitical_sensitivity": "high"
}

Bulk Assessment (up to 100 entities)

POST /risk-bulk
Content-Type: application/json

{
  "entities": [
    {
      "supplier_country": "CN",
      "transport_modes": ["sea"],
      "chokepoints": ["malacca"],
      "supplier_count": 1,
      "tier_depth": 2,
      "time_sensitivity": "just_in_time",
      "has_historical_disruptions": false
    },
    {
      "supplier_country": "DE",
      "transport_modes": ["rail"],
      "chokepoints": ["none"],
      "supplier_count": 5,
      "tier_depth": 1,
      "time_sensitivity": "buffered",
      "has_historical_disruptions": false
    }
  ]
}

📋 Input Parameters

Field	Type	Required	Description
`supplier_country`	string	Yes	ISO 3166-1 alpha-2 or alpha-3 country code (e.g., "CN", "USA")
`facility_region`	string	No	Geographic region: north_america, western_europe, east_asia, southeast_asia, etc.
`transport_modes`	array	Yes	Transport methods: "sea", "air", "rail", "road"
`chokepoints`	array	Yes	Transit chokepoints: "suez", "panama", "hormuz", "malacca", "gibraltar", "bosphorus", "none"
`supplier_count`	integer	Yes	Number of suppliers (1-100)
`tier_depth`	integer	Yes	Supply chain tier depth: 1, 2, or 3
`time_sensitivity`	string	Yes	Inventory strategy: "just_in_time", "buffered", "flexible"
`has_historical_disruptions`	boolean	Yes	Past disruption history
`regulatory_flags`	array	No	Compliance concerns: "export_control", "strategic_technology", etc.
`geopolitical_sensitivity`	string	No	Sensitivity level: "low", "medium", "high", "critical"

📤 Response Format

{
  "overall_score": 78,
  "risk_tier": "High",
  "dimensions": {
    "geopolitical": { "score": 85, "factors": ["High regional tension", "Export controls"] },
    "logistics": { "score": 70, "factors": ["Sea transport dependency"] },
    "concentration": { "score": 90, "factors": ["Single supplier"] },
    "transit": { "score": 75, "factors": ["Malacca Strait exposure"] },
    "regulatory": { "score": 65, "factors": ["Strategic technology controls"] }
  },
  "explainability": {
    "primary_drivers": ["Single-source dependency", "Geopolitical tension"],
    "contributing_factors": [
      { "factor": "Chokepoint exposure", "impact": "high", "description": "Malacca Strait dependency" }
    ]
  },
  "recommendations": [
    "Diversify supplier base to reduce concentration risk",
    "Consider alternative transport routes"
  ],
  "metadata": {
    "version": "1.0.0",
    "calculated_at": "2025-01-31T12:00:00Z"
  }
}

🏢 Use Cases

Procurement Teams – Evaluate supplier risk before onboarding
Supply Chain Managers – Monitor and prioritize risk mitigation efforts
Risk Analysts – Generate explainable risk reports for stakeholders
ERP Integrations – Embed real-time risk scoring into procurement workflows
Portfolio Assessment – Bulk analyze entire supplier networks

🔗 Endpoints

Endpoint	Method	Description
`/risk-score`	POST	Calculate risk score for a single entity
`/risk-bulk`	POST	Batch process up to 100 entities
`/risk-schema`	GET	Get complete API schema documentation
`/health`	GET	Service health check (no auth required)

💡 Support

For questions or support, contact us at supplyshield@protonmail.com