Skip to main content

BrainPredict Sourcing API Reference

Complete API documentation for BrainPredict Sourcing. RESTful API with JSON responses.

Base URL

https://api.brainpredict.ai/v1/sourcing

Authentication

All API requests require an API key in the header:

Authorization: Bearer bp_sourcing_live_your_api_key

Endpoints

POST/api/v1/sourcing/supplier-riskAnalyze supplier risk
POST/api/v1/sourcing/price-predictPredict commodity prices
POST/api/v1/sourcing/demand-forecastForecast procurement demand
POST/api/v1/sourcing/spend-classifyClassify spend data
POST/api/v1/sourcing/contract-optimizeOptimize contract terms
GET/api/v1/sourcing/suppliersList all suppliers
GET/api/v1/sourcing/contractsList all contracts
GET/api/v1/sourcing/spend-analyticsGet spend analytics

March 2026 Innovation APIs

NEW

Available on all BrainPredict installations from March 2026. Rate-limited by endpoint sensitivity (10–60 req/min).

POST/api/v1/braincode/compressBrainCodeBrainCode — compress + HMAC-seal a dataset (60-80% size reduction)
POST/api/v1/braincode/decompressBrainCodeBrainCode — verify seal + reconstruct dataset (returns 422 on tamper)
POST/api/v1/braincode/qualityBrainCodeBrainCode — Arrow-accelerated data quality check (null rates, quality score)
GET/api/v1/braincode/stats/:tenantBrainCodeBrainCode — engine statistics for a tenant
POST/api/v1/causal/grangerCausal AI v2Causal AI v2 — Granger causality test (F-test, lags 1..N)
POST/api/v1/causal/ateCausal AI v2Causal AI v2 — Average Treatment Effect via Propensity Score Matching + bootstrap 95% CI
POST/api/v1/causal/diff-in-diffCausal AI v2Causal AI v2 — Difference-in-Differences estimator (OLS interaction)
GET/api/v1/performance/onnxONNX RuntimeONNX Runtime — session registry stats (calls, avg latency, ort version)
GET/api/v1/performance/cacheInference CacheInference Cache — Redis hit rate, queue depth, availability
GET/api/v1/performance/summaryPerformancePerformance — unified health score (ONNX + cache + CPU reduction %)
GET/api/v1/compliance/dashboardCompliance SaaSCompliance SaaS — live posture (EU AI Act + GDPR + NIS2 + ISO 42001)
GET/api/v1/compliance/export/jsonCompliance SaaSCompliance SaaS — machine-readable audit bundle with SHA-256 checksum
POST/api/v1/compliance/assessCompliance SaaSCompliance SaaS — assess an AI system against selected frameworks
GET/api/v1/compliance/frameworksCompliance SaaSCompliance SaaS — list of supported regulatory frameworks

Example Request

curl -X POST https://api.brainpredict.ai/v1/sourcing/supplier-risk \
  -H "Authorization: Bearer bp_sourcing_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "supplier_id": "SUP-001",
    "supplier_name": "TechComponents Global",
    "annual_spend": 124000000,
    "category": "Electronics",
    "country": "Taiwan"
  }'

Example Response

{
  "supplier_id": "SUP-001",
  "risk_score": 23,
  "risk_level": "Low",
  "risk_factors": [
    {"factor": "Financial Stability", "score": 18, "trend": "stable"},
    {"factor": "Geopolitical Risk", "score": 32, "trend": "increasing"},
    {"factor": "Supply Chain Dependency", "score": 19, "trend": "stable"}
  ],
  "recommendations": [
    "Monitor geopolitical developments in Taiwan",
    "Consider secondary supplier qualification"
  ],
  "confidence": 0.93
}