Skip to main content

​
Base URL

https://api.simcel.io/insights/v1

​
Available endpoints

Demand

Demand volume, value, fill rate, and forecast accuracy over time

P&L

Full Profit & Loss stack from Gross Sales down to EBIT and DPM

Supply

Closing stock, service levels, dispatch volumes by DC or SKU — Coming Soon

Sustainability

CO2 footprint broken down by inbound, storage, and outbound — Coming Soon

​
Common request parameters

All Insights endpoints share these required parameters:
ParameterTypeRequiredDescription
planIdstring✅The plan to query
scenarioIdsstring[]✅Comma-separated scenario IDs (max 3)
intervalD|W|M|FY—Time aggregation, default M
dateFromdate—ISO 8601 start date
dateTodate—ISO 8601 end date
currencystring—ISO 4217 code, default: plan currency

​
Common response envelope

Every response follows this shape: 
{
  "meta": {
    "planId": "plan_9xKz2",
    "interval": "M",
    "currency": "USD",
    "generatedAt": "2025-04-14T10:32:00Z"
  },
  "scenarios": [
    {
      "scenarioId": "scen_abc",
      "scenarioName": "Committed",
      "scenarioColor": "#6366F1",
      // endpoint-specific data
    }
  ]
}
The scenarios array always preserves the order of scenarioIds you passed in.

​
Rate limits

PlanRequests/minuteRequests/day
Starter10100
Growth1001,000
EnterpriseCustomCustom
Rate limit headers are included on every response: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1713085320
See Rate Limits for full details.