Welcome to the SIMCEL API
SIMCEL is an Integrated Business Planning (IBP) platform that runs supply chain simulations across multiple scenarios — combining demand forecasts, supply planning, financial modelling, and sustainability metrics in one place. The SIMCEL Insights API exposes the computed output of those simulations so you can:- Build AI agents that reason over your supply chain data
- Create custom dashboards outside of the SIMCEL app
- Feed downstream systems (ERP, BI tools, reports) with scenario-aware KPIs
- Power automated ESG reporting with real CO2 footprint data
Quickstart
Make your first API call in under 5 minutes
Authentication
Learn how to obtain and use API tokens
API Reference
Browse all Insights API endpoints
Build an AI Agent
Step-by-step guide using Python + OpenAI
MCP Integration
Connect Claude, Cursor or any MCP-compatible agent to SIMCEL
Architecture Examples
ERP sync, AI agents, BI dashboards, Slack bots — see how to integrate
Core concepts
The SIMCEL API is built around three key entities:Plans
Plans
A Plan is the top-level container for your IBP cycle. It defines the planning horizon, currency, and the set of scenarios being compared. Every API request requires a
planId.Scenarios
Scenarios
A Scenario is a simulation run — it could be your Actual, Committed, Optimistic, or Conservative plan. The Insights API lets you compare up to 3 scenarios in a single request, which is the core value of SIMCEL.
KPIs
KPIs
KPIs are the computed outputs of each scenario simulation. The Insights API surfaces aggregated, finance-ready KPIs (not raw atomic data) — things like Net FIE Sales, EBIT, Service Level, and CO2 footprint.
Base URL
What’s available today
| Endpoint | Description | Status |
|---|---|---|
GET /demand-forecast | Demand volume, value, fill rate, forecast accuracy | ✅ Available |
GET /pnl-summary | Full P&L stack: gross sales → EBIT → DPM | ✅ Available |
GET /supply-performance | Closing stock, service levels, dispatch volumes | 🚧 Coming Soon |
GET /sustainability | CO2 by inbound / storage / outbound | 🚧 Coming Soon |
The Insights API is in public beta. Endpoints and response shapes are stable but may evolve. Breaking changes will be announced in the Changelog with at least 30 days notice.