# Status Codes Reference {#status-codes-reference}


Standard HTTP status codes returned by the Ever Gauzy API.


## Success Codes {#success-codes}


| Code | Status     | Description                  | Endpoints        |
| ---- | ---------- | ---------------------------- | ---------------- |
| 200  | OK         | Request successful           | GET, PUT, DELETE |
| 201  | Created    | Resource created             | POST             |
| 204  | No Content | Successful, no response body | DELETE           |


## Client Error Codes {#client-error-codes}


| Code | Status            | Description               | Common Cause      |
| ---- | ----------------- | ------------------------- | ----------------- |
| 400  | Bad Request       | Validation error          | Invalid input     |
| 401  | Unauthorized      | Missing/invalid JWT       | Expired token     |
| 403  | Forbidden         | Insufficient permissions  | Wrong role        |
| 404  | Not Found         | Resource doesn't exist    | Wrong ID / tenant |
| 409  | Conflict          | Duplicate resource        | Email in use      |
| 422  | Unprocessable     | Semantic validation error | Business rule     |
| 429  | Too Many Requests | Rate limit exceeded       | Too many calls    |


## Server Error Codes {#server-error-codes}


| Code | Status              | Description                  |
| ---- | ------------------- | ---------------------------- |
| 500  | Internal Error      | Unexpected server error      |
| 502  | Bad Gateway         | Upstream service unavailable |
| 503  | Service Unavailable | Server overloaded            |
| 504  | Gateway Timeout     | Upstream service timeout     |


## Error Response Format {#error-response-format}


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


## Related Pages {#related-pages}


- [Error Handling](https://sourcey-gauzy.pages.dev/api/error-handling/index.md) — error handling patterns
- [Error Handling Architecture](https://sourcey-gauzy.pages.dev/architecture/error-handling-architecture/index.md) — server-side