Governance API

Compile verdicts, verify provenance, score adequacy, detect contradictions, and execute governed payments through a single API.

Endpoints

GET/api/public-stats
Live governance statistics. No authentication required.
POST/api/kernel-core
Contradiction scan, temporal governance, full project scan.
POST/api/adequacy
Six-dimensional capital adequacy vector.
POST/api/simulate
Pre-verdict simulation with three-scenario analysis.
POST/api/dependency-graph
Governance compiler. 200+ engines, 6 layers, topological dependency resolution.
POST/api/notarization
Jurisdiction-aware notarization across 7 states.
POST/api/payment-rail
Governed payment execution via ACH and Fedwire.
POST/api/audit-verify
Verify any provenance hash independently.
POST/api/governance-sdk
Full SDK — 13 methods, HMAC-SHA256 signed responses.

Governance Rails

11 independent governance rails. Each returns a posture, score, findings, and provenance hash. Scan individually or all at once.

GET/api/governance-rails?action=scan_all
Master aggregator — scans all 11 rails, returns unified governance posture.
GET/api/system-risk?action=scan
System-level risk. Kernel integrity, rail health, governance consistency, capital safety, systemic anomalies.
GET/api/workforce-rail
Labor governance. Workforce compliance, subcontractor stability, CPRAL coverage.
GET/api/schedule-rail
Schedule governance. Slippage detection, pace lag, overdue project identification.
GET/api/safety-governance
Safety governance. OSHA violation tracking, incident detection, safety-driven capital gating.
GET/api/insurance-rail
Insurance governance. COI coverage, expired certificate detection, coverage gap analysis.
GET/api/environmental-rail
Environmental governance. ESG tracking, emissions monitoring, environmental compliance.
GET/api/procurement-rail
Procurement governance. Supply chain risk, material tracking, vendor reliability.
GET/api/equipment-rail
Equipment governance. Utilization intelligence, maintenance compliance, failure prediction.
GET/api/weather-rail
Weather governance. Climate risk, thermal scans, weather-driven delay prediction.
GET/api/counterparty-rail
Counterparty governance. Concentration risk, GC exposure, surety solvency.
GET/api/market-rail
Market intelligence. CO velocity, cost escalation, construction economics.

Quick Start

// Scan a project for contradictions
const response = await fetch('https://app.buildpaid.ai/api/kernel-core', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    action: 'full_scan',
    project_id: 'prj_xxx'
  })
});

const { scan_verdict, contradictions } = await response.json();
// scan_verdict: "CLEAN" | "WARNING" | "BLOCKED"
// Verify a provenance hash
const response = await fetch('https://app.buildpaid.ai/api/audit-verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ hash: '9fb7534ad022...' })
});
// Returns: AUTHENTIC or TAMPERED

Pricing

Scan
$0.50
per scan
Contradiction detection
Temporal governance
Provenance-anchored verdict
Govern
$50
per project / month
Full 17-engine compilation
Unlimited verdicts
Notarization included
Payment rail access
Enterprise
Custom
volume pricing
Dedicated support
Custom governance profiles
SOC 2 attestation
SLA guarantee

Authentication

All authenticated endpoints require a Bearer token. API keys are issued per organization. Each SDK response is HMAC-SHA256 signed for tamper detection.

Authorization: Bearer bp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx