> For the complete documentation index, see [llms.txt](https://skyhub-english.gitbook.io/skyhub-api-english/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://skyhub-english.gitbook.io/skyhub-api-english/http-response-status-codes.md).

# HTTP Response Status Codes

SkyHub uses the default group of HTTP statuses to indicate whether a request was successful or not.

| Status Code        | Description                                                                                                                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **HTTP 2xx Codes** | Indicate that the request was successful;                                                                                      |
| **HTTP 4xx Codes** | indicate that the request contains some incorrect information - incorrect access data, absence of a required field, and so on; |
| **HTTP 5xx Codes** | Indicates an error on SkyHub's servers. These are rare, and if you receive this code, you should contact our support.          |

## Erros

Whenever an error occurs, the API will return in the body of the message a JSON with an error message according to the format below:

```
{error: "error message"}
```

## HTTP Status

The most commonly used HTTP statuses are:

| Status     | Description                                                                                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200        | **Success -** The request was processed successfully                                                                                                                                        |
| 201        | **Created -** The request was successfully processed and resulted in a new feature created                                                                                                  |
| 204        | **No content -** The request was successfully processed and there is no additional content in the response                                                                                  |
| 400        | **Malformed request -** The request does not conform to the expected format. Check the JSON (body) being sent                                                                               |
| 401        | **Not authenticated -** Authentication data is incorrect. Check the header of the request for the email and the token                                                                       |
| 403        | **Unauthorized -** You are trying to access a resource you are not allowed to                                                                                                               |
| 404        | **Not found -** You are trying to access a resource that does not exist on SkyHub                                                                                                           |
| 406        | **Format Not Accepted -** SkyHub does not support the data format specified in the header (Accept)                                                                                          |
| 415        | **Media format not supported -** SkyHub can not process the uploaded data by its format. Be sure to use the UTF-8 charset (both in the "Content-Type" header and in the request's own body) |
| 422        | **Semantic error -** Despite the request be in the correct format, the data avoid some business rule (eg invalid transition from order status)                                              |
| 429        | **Exceeded request limit -** You have made more requests than allowed in a given resource                                                                                                   |
| 500 or 502 | **Internal error -** An error occurred on the SkyHub server when attempting to process the request                                                                                          |
| 503        | **Service unavailable -** SkyHub API is temporarily down                                                                                                                                    |
| 504        | **Timeout -** The request took a long time and can not be processed                                                                                                                         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://skyhub-english.gitbook.io/skyhub-api-english/http-response-status-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.