# Response status codes

| Code                      | Explain                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 OK                    | The request was successfully processed by ShopBase.                                                                                                                                                                                                                                                                                                                             |
| 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.                                                                                                                                                                                                                                                                                                                           |
| 303 See Other             | The response to the request can be found under a different URI in the `Location`header and can be retrieved using a GET method on that resource.                                                                                                                                                                                                                                |
| 400 Bad Request           | <p>The request was not understood by the server, generally due to bad syntax or because the <code>Content-Type</code> header was not correctly set to <code>application/json</code>.</p><p>This status is also returned when the request provides an invalid <code>code</code> parameter during the <a href="/pages/-Lbh6_ie9A2klA0fYeS7">OAuth</a> token exchange process.</p> |
| 401 Unauthorized          | The necessary [authentication credentials](/build-an-app/making-your-first-request/authentication.md) are not present in the request or are incorrect.                                                                                                                                                                                                                          |
| 402 Payment Required      | The requested shop is currently frozen.                                                                                                                                                                                                                                                                                                                                         |
| 403 Forbidden             | The server is refusing to respond to the request. This is generally because you have not [requested the appropriate scope](/build-an-app/making-your-first-request/authentication/api-access-scopes.md) for this action.                                                                                                                                                        |
| 404 Not Found             | The requested resource was not found but could be available again in the future.                                                                                                                                                                                                                                                                                                |
| 406 Not Acceptable        | The requested resource is only capable of generating content not acceptable according to the Accept headers sent in the request.                                                                                                                                                                                                                                                |
| 422 Unprocessable Entity  | The request body was well-formed but contains semantical errors. The response body will provide more details in the `errors` or `error` parameters.                                                                                                                                                                                                                             |
| 423 Locked                | The requested shop is currently locked.                                                                                                                                                                                                                                                                                                                                         |
| 429 Too Many Requests     | The request was not accepted because the application has exceeded the rate limit. See the API Call Limit documentation for a breakdown of ShopBase's rate-limiting mechanism.                                                                                                                                                                                                   |
| 500 Internal Server Error | An internal error occurred in ShopBase. Please contact our support so that ShopBase staff can investigate.                                                                                                                                                                                                                                                                      |
| 501 Not Implemented       | The requested endpoint is not available on that particular shop, e.g. requesting access to a Plus-specific API on a non-Plus shop. This response may also indicate that this endpoint is reserved for future use.                                                                                                                                                               |
| 503 Service Unavailable   | The server is currently unavailable. Check the status page for reported service outages.                                                                                                                                                                                                                                                                                        |
| 504 Gateway Timeout       | The request could not complete in time. Try breaking it down in multiple smaller requests.                                                                                                                                                                                                                                                                                      |


---

# Agent Instructions: 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:

```
GET https://developers.shopbase.com/build-an-app/making-your-first-request/response-status-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
