> For the complete documentation index, see [llms.txt](https://developers.shopbase.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.shopbase.com/build-an-app/making-your-first-request/response-status-codes.md).

# 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.                                                                                                                                                                                                                                                                                      |