Skip to main content

Smart City API Reference

32 REST endpoints across 10 functional groups. Base URL: https://api.brainpredict.ai. Auth: Bearer <bp_smart_city_*>.

Conformal prediction + HITL enforcement

Every prediction endpoint returns a conformal interval [lower, upper] at α=0.10 (≥90% PAC coverage). High-risk Annex III endpoints (flood, emergency dispatch, crime score, City Brain) enforce the EU AI Act Art.14 HITL gate when confidence falls below the per-endpoint threshold.

Core platform

GET/api/v1/smart-city/status— Platform health + live model count + conformal coverage
GET/api/v1/smart-city/models— List all 35 models with MoE expert binding + risk class

Traffic & mobility

POST/api/v1/smart-city/traffic/signal/adapt— Adaptive signal control with conformal band
POST/api/v1/smart-city/traffic/incident/detect— Real-time incident detection on CCTV frames
GET/api/v1/smart-city/traffic/corridor/{id}/state— Corridor state + predicted wait times
POST/api/v1/smart-city/mobility/routing/multimodal— Multimodal OD routing + modal-share optimisation

Energy grid

POST/api/v1/smart-city/energy/forecast— 24h substation load forecast + conformal ICP
POST/api/v1/smart-city/energy/demand-response— DR dispatch under EU EED — returns action plan
POST/api/v1/smart-city/energy/renewable/forecast— Solar / wind generation forecast
POST/api/v1/smart-city/energy/battery/optimise— Battery fleet dispatch (ToU + frequency)

Emergency & safety

POST/api/v1/smart-city/emergency/flood/predict— Flood early-warning — HITL-gated (Annex III)
POST/api/v1/smart-city/emergency/dispatch— Multi-agency dispatch — HITL-gated
POST/api/v1/smart-city/safety/air-quality/forecast— PM2.5 / NO₂ / O₃ 72h forecast
POST/api/v1/smart-city/safety/crime/score— Hotspot score — HITL-gated + fairness-constrained

Water & environment

POST/api/v1/smart-city/water/demand/forecast— Daily demand + leak candidate list
POST/api/v1/smart-city/waste/route/optimise— Collection route optimisation
POST/api/v1/smart-city/env/heat-island/predict— UHI micro-climate prediction

City Brain & infrastructure

POST/api/v1/smart-city/brain/decide— Cross-domain City Brain orchestrator — HITL-gated
POST/api/v1/smart-city/infra/health/score— Bridge / tunnel / pipeline fatigue score
POST/api/v1/smart-city/privacy/risk/score— Per-endpoint DP-ε + GDPR exposure scoring

ESG & ISO 37120

POST/api/v1/smart-city/kpi/ingest— Ingest ISO 37120 indicators (energy / water / waste / mobility)
GET/api/v1/smart-city/esg/dashboard— Live CSRD ESRS dashboard — E1/E2/E3/E5/S1
POST/api/v1/smart-city/esg/csrd/export— Export XBRL/iXBRL CSRD report with evidence chain

Digital Twin Federation (BP-106)

POST/api/v1/smart-city/federation/join— Join multi-city consortium with DP-ε
POST/api/v1/smart-city/federation/sync— Run FedAvg round — returns aggregated KPI model
GET/api/v1/smart-city/federation/status— Federation health + correlation graph
POST/api/v1/smart-city/federation/correlate— Pearson ICP correlation discovery across cities

Sovereign deployment (BP-105a claim 4)

POST/api/v1/smart-city/sovereign/manifest/verify— Verify Ed25519-signed deployment manifest
POST/api/v1/smart-city/sovereign/kit/build— Build air-gapped 35-model kit for RPi4 CM4+
GET/api/v1/smart-city/sovereign/attestation— BLP MAC + Dilithium-3 runtime attestation

Cross-platform bridges (BP-105a)

GET/api/v1/smart-city/bridges/finance/status— SC × Finance bridge — CSRD E1 accrual + IAS 16 CapEx
GET/api/v1/smart-city/bridges/risk/status— SC × Risk bridge — DORA Art.11 + NIS2 Art.21
GET/api/v1/smart-city/bridges/operations/status— SC × Operations bridge — ISO 55000 + EU EED