> For the complete documentation index, see [llms.txt](https://docs.hello-lisa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hello-lisa.com/developers/rest-api/response-status-and-error-codes.md).

# Response status and error codes

When LiSA receives a request to an API endpoint, a number of different HTTP status codes can be returned in the response depending on the original request.

| Status Code                 | Explanation                                                                                                                                                                                                                                                                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200 OK`                    | The request was successfully processed by LiSA.                                                                                                                                                                                                                                                                                           |
| `201 Created`               | The request has been fulfilled and a new resource has been created.                                                                                                                                                                                                                                                                       |
| `202 Accepted`              | The request has been accepted, but not yet processed.                                                                                                                                                                                                                                                                                     |
| `400 Bad Request`           | <p>The request wasn't understood by the server, generally due to bad syntax or because the</p><p>Content-Type header wasn't correctly set to application/json.</p>                                                                                                                                                                        |
| `401 Unauthorized`          | The necessary Authentication are not present in the request or are incorrect.                                                                                                                                                                                                                                                             |
| `403 Forbidden`             | <p>The server is refusing to respond to the request.</p><p>This status is generally returned if you haven't requested the appropriate scope for this action.</p>                                                                                                                                                                          |
| `404 Not Found`             | The requested resource was not found but could be available again in the future.                                                                                                                                                                                                                                                          |
| `422 Unprocessable Entity`  | <p>The request body was well-formed but contains semantic errors.</p><p>A <code>422</code> error code can be returned from a variety of scenarios including, but not limited to: </p><p>Incorrectly formatted input Creating resources with omitted required fields</p><p>The response body provides details in the error parameters.</p> |
| `429 Too Many Requests`     | The request was not accepted because the application has exceeded the rate limit. Learn more about LiSA Rate limits                                                                                                                                                                                                                       |
| `500 Internal Server Error` | An internal error occurred.                                                                                                                                                                                                                                                                                                               |
| `503 Service Unavailable`   | The server is currently unavailable.                                                                                                                                                                                                                                                                                                      |
| `504 Gateway Timeout`       | The request could not complete in time.                                                                                                                                                                                                                                                                                                   |
