Error Handling

The Skaala API uses conventional HTTP response codes to indicate success or failure.

HTTP Status Codes

Code	Meaning
200	Success - Request completed successfully
201	Created - Resource created successfully
400	Bad Request - Invalid parameters or request body
401	Unauthorized - Invalid or missing API key
403	Forbidden - Valid API key but insufficient permissions
404	Not Found - Resource doesn’t exist
429	Too Many Requests - Rate limit exceeded
500	Server Error - Something went wrong on our end

{
  "error": "validation_error",
  "message": "Invalid request parameters",
  "fields": {
    "start_time": "Must be a valid ISO 8601 datetime"
  }
}