Error Handling

The API returns standard HTTP status codes and JSON error bodies.

Error Response Format

{
  "statusCode": 400,
  "message": ["email must be an email"],
  "error": "Bad Request"
}

Field	Description
`statusCode`	HTTP status code
`message`	Error message (string or array)
`error`	Short error label

Code	Meaning
`200`	OK — request succeeded
`201`	Created — resource created
`400`	Bad Request — validation failed
`401`	Unauthorized — missing or invalid token
`403`	Forbidden — insufficient permissions
`404`	Not Found — resource does not exist
`429`	Too Many Requests — rate limit exceeded
`500`	Internal Server Error — unexpected server failure

The API uses class-validator with ValidationPipe. Invalid request bodies return a 400 with an array of messages describing each field error.

{
  "statusCode": 400,
  "message": [
    "name should not be empty",
    "email must be an email"
  ],
  "error": "Bad Request"
}