Error Codes

The API uses standard HTTP status codes and returns errors in a consistent JSON format.

Error Response Format

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found",
    "status": 404
  }
}

Common Error Codes

StatusCodeDescription
400bad_requestThe request body is malformed or missing required fields
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks required permissions
404not_foundThe requested resource does not exist
409conflictResource already exists or state conflict
422validation_errorRequest failed validation
429rate_limitedToo many requests
500internal_errorAn unexpected error occurred