> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vaultcord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors and Limits

> Explore the errors and rate-limits that you could encounter whilst using the API

| Code  | Description                                                                                |
| ----- | ------------------------------------------------------------------------------------------ |
| `400` | Bad Request - Invalid parameters.                                                          |
| `401` | Unauthorized - Unable to authenticate.                                                     |
| `403` | Forbidden - The request is not allowed.                                                    |
| `404` | Not Found - The specified resource could not be found.                                     |
| `406` | Not Acceptable - You requested a format that isn't JSON.                                   |
| `429` | Too Many Requests - You have reached the rate limit.                                       |
| `500` | Internal Server Error - We had a problem with our server. Try again later. These are rare. |
| `503` | Service Unavailable - We're temporarily offline for maintenance. Please try again later.   |

## Rate-limits

Rate-limiting errors (`429`) happen when you are sending too many requests to the developers API.

### How it works

Our rate-limiting system is based on 10-second intervals rather than 1, meaning that you can make a burst of API calls within the first second, then wait 9 seconds and do it again.

<Info>For example, if you are on the `Standard` tier with 50 req/10s, you can send 50 requests within a second, then wait 9 seconds to send the others and it would work.</Info>

If you go over the allowed rate-limit for your tier, we <Tooltip tip="The WAF will block any requests exceeding the configured rate, and the remaining requests will be allowed. For example, if you send 60 requests in 10 seconds when you're only allowed to send 50, 10 will be blocked. You will not be rate-limited for X minutes after this, you will be able to immediately send other requests.">throttle your requests over the maximum configured rate for that tier</Tooltip>.

### General endpoints

All VaultCord API endpoints are rate-limited. Based on your tier, you have access to different rate-limiting values.

<Note>To upgrade to a higher tier, please reach out to us through our [Discord community](https://vaultcord.com/discord)</Note>

| Tier       | Limits      |
| ---------- | ----------- |
| `Standard` | 50 req/10s  |
| `Premium`  | 100 req/10s |

<Card title="Contact Live Chat Support" icon="headset" href="https://vaultcord.com/discord">
  Our support team is available through Live Chat on our website. Please share your Order ID or the email you used for the transaction so we can help you faster.
</Card>
