Error Codes

The RukkyHub API returns HTTP status codes and JSON error messages to help you debug issues. Always check the response body for details.

HTTP Status Codes

Common Error Messages

Error Response Format

Errors return a consistent JSON structure:

// Simple error
{
  "error": "Insufficient balance"
}

// Validation errors
{
  "errors": {
    "service": ["The selected service is invalid."],
    "quantity": ["The quantity field is required."]
  }
}

// Both error and errors can be present:
{
  "error": "Insufficient balance",
  "errors": {
    "balance": ["Your account balance is too low for this order"]
  }
}