This section details how the API handles and reports errors.

Errors are returned as a JSON object with an error message and code:

{ "success": false, "message": "Invalid API token", "code": "AUTH_001" }

The API uses standard HTTP status codes:

Code	Meaning
200	OK - Request succeeded
400	Bad Request - Invalid parameters
401	Unauthorized - Missing or invalid token
403	Forbidden - Insufficient permissions
404	Not Found - Resource does not exist
500	Server Error - Internal server failure