# Errors

Simple OKR uses conventional HTTP response codes to indicate the success or failure of an API request. In general: codes in the `2xx` range indicate success. Codes in the `4xx` range indicate an error that failed given the information provided (e.g., a required parameter was omitted). Codes in the `5xx` range indicate an error with Simple OKR servers.

### Error response object <a href="#error-response-object" id="error-response-object"></a>

Errors returned by all Simple OKR APIs use the same error response structure:

| Attribute | Type             | Description                                                     |
| --------- | ---------------- | --------------------------------------------------------------- |
| code      | integer          | HTTP status code                                                |
| message   | string           | Human readable error summary                                    |
| details   | object, optional | A free form object providing additional details about the error |

Example:

```javascript
{
  "code": 400,
  "message": "invalid request",
  "details": {
    "name": "name is required"
  }
}
```