Skip to main content

​
Error response format

{
  "detail": "Human-readable error message"
}
Validation errors (422) return additional detail about the affected fields: 
{
  "detail": [
    {
      "loc": ["body", "battery_level_start"],
      "msg": "Input should be greater than or equal to 0.1",
      "type": "greater_than_equal"
    }
  ]
}

​
Status codes

CodeMeaningCommon causes
200SuccessRequest processed successfully
202AcceptedOptimization job submitted (POST /planner/v2)
400Bad RequestInvalid input, e.g. malformed time format
401UnauthorizedMissing or invalid Bearer token
404Not FoundVehicle or resource not found
422Validation ErrorRequest body fails schema validation (e.g. battery_level_start out of range)
429Too Many RequestsRate limit exceeded — see Limitations
500Internal ErrorServer-side issue — contact support
502Bad GatewayOptimization service temporarily unavailable — retry after a few seconds