Error Reference

This guide provides a complete reference for all error codes returned by the BrainUs API, along with troubleshooting steps.

Error Response Format

All API errors follow a consistent JSON structure:

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key",
    "details": {
      "reason": "The provided API key is invalid or has been revoked"
    }
  }
}

HTTP Status Codes

Error Categories

• Common Errors - Most frequent errors and fixes
• Authentication Errors - API key issues
• Rate Limit Errors - Quota exceeded
• Validation Errors - Invalid parameters