Skip to main content
All errors follow a consistent shape: 
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Human-readable description of the problem"
}

​
HTTP status codes

CodeMeaningCommon cause
400Bad RequestMissing required parameter, invalid interval, too many scenarioIds
401UnauthorizedMissing Authorization header, expired token
403ForbiddenToken lacks required scope
404Not FoundplanId or scenarioId doesn’t exist, or you don’t have access
422Unprocessable EntityParameter values are syntactically valid but semantically wrong (e.g. dateFrom after dateTo)
429Too Many RequestsRate limit exceeded — see Rate Limits
500Internal Server ErrorSomething went wrong on our end — contact support

​
Common error messages

You passed more than 3 scenario IDs. The Insights API supports a maximum of 3 scenarios per request for performance reasons.Fix: Split into multiple requests if you need more than 3 scenarios.
Your token has expired (tokens last 1 hour) or you forgot to include the Authorization header.Fix: Re-authenticate via POST /auth/token and use the new token.
The planId doesn’t exist in your workspace, or your API key doesn’t have access to it.Fix: List your available plans with GET /insights/v1/plans to find valid IDs.
Your date range is inverted.Fix: Ensure dateFrom is earlier than dateTo.
The scenario exists but has never been simulated, or the simulation is still running.Fix: Run the scenario simulation in the SIMCEL app first, then retry. The meta.generatedAt field will be present once data is available.