Home/Guides/Error Codes

Error Codes

Understanding API error responses.

Error Response Format

All error responses follow a consistent JSON format:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "email is required",
    "details": { ... }
  }
}

Status	Title	Description
400	Bad Request	The request body or parameters are invalid.
401	Unauthorized	No valid session or token was provided.
403	Forbidden	The user does not have permission for this action.
404	Not Found	The requested resource does not exist.
409	Conflict	The request conflicts with current state (e.g. duplicate entry).
422	Unprocessable Entity	The request is well-formed but contains semantic errors.
429	Too Many Requests	Rate limit exceeded. See the Rate Limiting guide.
500	Internal Server Error	An unexpected error occurred on the server.